@mcoda/core 0.1.8 → 0.1.11

package/dist/services/review/ReviewNormalizer.d.ts

@@ -0,0 +1,9 @@
+import type { ReviewAgentResult } from "./CodeReviewService.js";
+export interface ReviewNormalizationResult {
+    result: ReviewAgentResult;
+    parsedFromJson: boolean;
+    usedFallback: boolean;
+    issues: string[];
+}
+export declare const normalizeReviewOutput: (raw: string) => ReviewNormalizationResult;
+//# sourceMappingURL=ReviewNormalizer.d.ts.map

package/dist/services/review/ReviewNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewNormalizer.d.ts","sourceRoot":"","sources":["../../../src/services/review/ReviewNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAgID,eAAO,MAAM,qBAAqB,GAAI,KAAK,MAAM,KAAG,yBAoBnD,CAAC"}

package/dist/services/review/ReviewNormalizer.js

@@ -0,0 +1,147 @@
+const VALID_DECISIONS = [
+    "approve",
+    "changes_requested",
+    "block",
+    "info_only",
+];
+const DEFAULT_SUMMARY = "Review output was unstructured; treated as informational.";
+const normalizeDecision = (value) => {
+    if (!value)
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    if (normalized === "approved")
+        return "approve";
+    if (VALID_DECISIONS.includes(normalized)) {
+        return normalized;
+    }
+    return undefined;
+};
+const decisionFromText = (raw) => {
+    const normalized = raw.toLowerCase();
+    const explicit = normalized.match(/decision\\s*[:=-]?\\s*(approve|approved|changes_requested|changes requested|block|info_only)/i);
+    if (explicit) {
+        const mapped = explicit[1]?.replace(" ", "_");
+        return normalizeDecision(mapped) ?? "info_only";
+    }
+    if (/(block|reject|fatal|critical)/i.test(normalized))
+        return "block";
+    if (/(changes_requested|changes requested|request changes)/i.test(normalized))
+        return "changes_requested";
+    if (/(approve|approved|looks good|ship it)/i.test(normalized))
+        return "approve";
+    return "info_only";
+};
+const summaryFromText = (raw) => {
+    const match = raw.match(/summary\\s*[:=-]?\\s*(.+)/i);
+    if (match?.[1]) {
+        const summary = match[1].trim();
+        if (summary)
+            return summary;
+    }
+    const firstLine = raw.split(/\\r?\\n/).find((line) => line.trim());
+    return firstLine?.trim() || undefined;
+};
+const sanitizeFindings = (findings) => {
+    if (!Array.isArray(findings))
+        return [];
+    return findings.filter((finding) => Boolean(finding && typeof finding === "object"));
+};
+const coerceResult = (raw, partial, forcedDecision) => {
+    const decision = normalizeDecision(partial.decision) ?? forcedDecision ?? decisionFromText(raw);
+    const summary = partial.summary?.trim() || summaryFromText(raw) || DEFAULT_SUMMARY;
+    return {
+        decision,
+        summary,
+        findings: sanitizeFindings(partial.findings),
+        testRecommendations: Array.isArray(partial.testRecommendations) ? partial.testRecommendations : [],
+        resolvedSlugs: Array.isArray(partial.resolvedSlugs) ? partial.resolvedSlugs : undefined,
+        unresolvedSlugs: Array.isArray(partial.unresolvedSlugs) ? partial.unresolvedSlugs : undefined,
+        raw,
+    };
+};
+const extractJsonCandidates = (raw) => {
+    const candidates = [];
+    if (!raw)
+        return candidates;
+    const fenceRegex = /```(?:json)?\\s*([\\s\\S]*?)```/gi;
+    let match = fenceRegex.exec(raw);
+    while (match) {
+        const fenced = match[1]?.trim();
+        if (fenced)
+            candidates.push(fenced);
+        match = fenceRegex.exec(raw);
+    }
+    const text = raw;
+    let inString = false;
+    let escape = false;
+    let depth = 0;
+    let startIndex = -1;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i] ?? "";
+        if (inString) {
+            if (escape) {
+                escape = false;
+            }
+            else if (ch === "\\\\") {
+                escape = true;
+            }
+            else if (ch === "\"") {
+                inString = false;
+            }
+            continue;
+        }
+        if (ch === "\"") {
+            inString = true;
+            continue;
+        }
+        if (ch === "{") {
+            if (depth === 0)
+                startIndex = i;
+            depth += 1;
+            continue;
+        }
+        if (ch === "}" && depth > 0) {
+            depth -= 1;
+            if (depth === 0 && startIndex >= 0) {
+                const candidate = text.slice(startIndex, i + 1).trim();
+                if (candidate)
+                    candidates.push(candidate);
+                startIndex = -1;
+            }
+        }
+    }
+    return candidates;
+};
+const parseJsonCandidate = (candidate) => {
+    try {
+        const parsed = JSON.parse(candidate);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+};
+export const normalizeReviewOutput = (raw) => {
+    const issues = [];
+    const candidates = extractJsonCandidates(raw);
+    for (const candidate of candidates) {
+        const parsed = parseJsonCandidate(candidate);
+        if (parsed) {
+            const result = coerceResult(raw, parsed);
+            if (!normalizeDecision(parsed.decision)) {
+                issues.push("coerced_decision");
+            }
+            if (!parsed.summary) {
+                issues.push("coerced_summary");
+            }
+            return { result, parsedFromJson: true, usedFallback: false, issues };
+        }
+    }
+    const fallback = coerceResult(raw, {}, "info_only");
+    issues.push("non_json_output");
+    return { result: fallback, parsedFromJson: false, usedFallback: true, issues };
+};

package/dist/services/shared/AuthErrors.d.ts

@@ -0,0 +1,3 @@
+export declare const AUTH_ERROR_REASON = "auth_error";
+export declare const isAuthErrorMessage: (message?: string | null) => boolean;
+//# sourceMappingURL=AuthErrors.d.ts.map

package/dist/services/shared/AuthErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthErrors.d.ts","sourceRoot":"","sources":["../../../src/services/shared/AuthErrors.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,GAAG,IAAI,KAAG,OAG5D,CAAC"}

package/dist/services/shared/AuthErrors.js

@@ -0,0 +1,17 @@
+const AUTH_ERROR_PATTERNS = [
+    /auth_error/i,
+    /usage_limit_reached/i,
+    /too many requests/i,
+    /http\s*429/i,
+    /rate limit/i,
+    /usage limit/i,
+    /invalid[_\s-]*api[_\s-]*key/i,
+    /no openai api key/i,
+    /insufficient[_\s-]*quota/i,
+];
+export const AUTH_ERROR_REASON = "auth_error";
+export const isAuthErrorMessage = (message) => {
+    if (!message)
+        return false;
+    return AUTH_ERROR_PATTERNS.some((pattern) => pattern.test(message));
+};

package/dist/services/shared/DocdexGuidance.d.ts

@@ -0,0 +1,7 @@
+export type DocdexGuidanceOptions = {
+    contextLabel: string;
+    includeHeading?: boolean;
+    includeFallback?: boolean;
+};
+export declare const buildDocdexUsageGuidance: ({ contextLabel, includeHeading, includeFallback, }: DocdexGuidanceOptions) => string;
+//# sourceMappingURL=DocdexGuidance.d.ts.map

package/dist/services/shared/DocdexGuidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocdexGuidance.d.ts","sourceRoot":"","sources":["../../../src/services/shared/DocdexGuidance.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAKF,eAAO,MAAM,wBAAwB,GAAI,oDAItC,qBAAqB,KAAG,MAY1B,CAAC"}

package/dist/services/shared/DocdexGuidance.js

@@ -0,0 +1,12 @@
+const DOCDEX_QUERY_EXAMPLE = "`docdexd search --repo <workspaceRoot> --query \"<query>\"` or `DOCDEX_REPO=<workspaceRoot> docdexd search --query \"<query>\"`";
+export const buildDocdexUsageGuidance = ({ contextLabel, includeHeading = false, includeFallback = true, }) => {
+    const lines = [];
+    if (includeHeading) {
+        lines.push("## Docdex Usage (required)");
+    }
+    lines.push("Docdex context is injected by mcoda; do not run docdexd directly.");
+    lines.push(`If more context is needed, list the exact docdex queries in ${contextLabel} and always scope to the repo (example: ${DOCDEX_QUERY_EXAMPLE}).`);
+    const fallback = includeFallback ? " and fall back to local docs." : ".";
+    lines.push(`If docdex is unavailable or returns no results, say so in ${contextLabel}${fallback}`);
+    return lines.join("\n");
+};

package/dist/services/shared/ProjectGuidance.d.ts

@@ -0,0 +1,17 @@
+export type ProjectGuidance = {
+    content: string;
+    source: string;
+};
+export declare const isDocContextExcluded: (value: string | undefined, allowQaDocs?: boolean) => boolean;
+export declare const normalizeDocType: (params: {
+    docType?: string;
+    path?: string;
+    title?: string;
+    content?: string;
+}) => {
+    docType: string;
+    downgraded: boolean;
+    reason?: string;
+};
+export declare const loadProjectGuidance: (workspaceRoot: string, mcodaDir?: string) => Promise<ProjectGuidance | null>;
+//# sourceMappingURL=ProjectGuidance.d.ts.map

package/dist/services/shared/ProjectGuidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectGuidance.d.ts","sourceRoot":"","sources":["../../../src/services/shared/ProjectGuidance.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAeF,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,GAAG,SAAS,EAAE,qBAAmB,KAAG,OAMrF,CAAC;AAoBF,eAAO,MAAM,gBAAgB,GAAI,QAAQ;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAe1D,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,eAAe,MAAM,EACrB,WAAW,MAAM,KAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAchC,CAAC"}

package/dist/services/shared/ProjectGuidance.js

@@ -0,0 +1,78 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { PathHelper } from "@mcoda/shared";
+const QA_DOC_PATTERN = /(^|[\\/])(qa|e2e)([-_/]|$)/i;
+const MCODA_DOC_PATTERN = /(^|[\\/])\.mcoda([\\/]|$)/i;
+const SDS_DOC_PATTERN = /(^|[\\/])docs[\\/]+sds([\\/]|$)/i;
+const FRONTMATTER_BLOCK = /^---[\s\S]*?\n---/;
+const guidanceCandidates = (workspaceRoot, mcodaDir) => {
+    const resolvedMcodaDir = mcodaDir ?? PathHelper.getWorkspaceDir(workspaceRoot);
+    return [
+        path.join(resolvedMcodaDir, "docs", "project-guidance.md"),
+        path.join(workspaceRoot, "docs", "project-guidance.md"),
+    ];
+};
+export const isDocContextExcluded = (value, allowQaDocs = false) => {
+    if (!value)
+        return false;
+    const normalized = value.replace(/\\/g, "/");
+    if (MCODA_DOC_PATTERN.test(normalized))
+        return true;
+    if (!allowQaDocs && QA_DOC_PATTERN.test(normalized))
+        return true;
+    return false;
+};
+const extractFrontmatter = (content) => {
+    if (!content)
+        return undefined;
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith("---"))
+        return undefined;
+    const match = trimmed.match(FRONTMATTER_BLOCK);
+    return match ? match[0] : undefined;
+};
+const hasSdsFrontmatter = (content) => {
+    if (!content)
+        return false;
+    const frontmatter = extractFrontmatter(content);
+    if (!frontmatter)
+        return false;
+    if (/(doc_type|doctype|docType|type)\s*:\s*sds\b/i.test(frontmatter))
+        return true;
+    if (/(tags?|categories)\s*:\s*\[?[^\n]*\bsds\b/i.test(frontmatter))
+        return true;
+    if (/sds\s*:\s*true/i.test(frontmatter))
+        return true;
+    return false;
+};
+export const normalizeDocType = (params) => {
+    const raw = (params.docType ?? "DOC").trim();
+    const normalizedType = raw ? raw.toUpperCase() : "DOC";
+    if (normalizedType !== "SDS") {
+        return { docType: normalizedType || "DOC", downgraded: false };
+    }
+    const pathValue = params.path ?? params.title ?? "";
+    const normalizedPath = pathValue.replace(/\\/g, "/");
+    const inSdsPath = SDS_DOC_PATTERN.test(normalizedPath);
+    const frontmatter = hasSdsFrontmatter(params.content);
+    if (inSdsPath || frontmatter) {
+        return { docType: "SDS", downgraded: false };
+    }
+    const reason = [inSdsPath ? null : "path_not_sds", frontmatter ? null : "frontmatter_missing"].filter(Boolean).join("|");
+    return { docType: "DOC", downgraded: true, reason: reason || "not_sds" };
+};
+export const loadProjectGuidance = async (workspaceRoot, mcodaDir) => {
+    for (const candidate of guidanceCandidates(workspaceRoot, mcodaDir)) {
+        try {
+            const content = (await fs.readFile(candidate, "utf8")).trim();
+            if (!content)
+                continue;
+            return { content, source: candidate };
+        }
+        catch {
+            // ignore missing file
+        }
+    }
+    console.warn(`[project-guidance] no project guidance found; searched: ${guidanceCandidates(workspaceRoot, mcodaDir).join(", ")}`);
+    return null;
+};

package/dist/services/system/ToolDenylist.d.ts

@@ -0,0 +1,13 @@
+export declare class ToolDenylist {
+    private readonly entries;
+    private constructor();
+    static load(options?: {
+        mcodaDir?: string;
+        env?: NodeJS.ProcessEnv;
+    }): Promise<ToolDenylist>;
+    list(): string[];
+    match(name: string): string | undefined;
+    findMatch(names: Array<string | undefined>): string | undefined;
+    formatViolation(matched: string): string;
+}
+//# sourceMappingURL=ToolDenylist.d.ts.map

package/dist/services/system/ToolDenylist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolDenylist.d.ts","sourceRoot":"","sources":["../../../src/services/system/ToolDenylist.ts"],"names":[],"mappings":"AA6CA,qBAAa,YAAY;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO;IAA5C,OAAO;WAEM,IAAI,CAAC,OAAO,GAAE;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC;IAc9B,IAAI,IAAI,MAAM,EAAE;IAIhB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKvC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS;IAS/D,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAOzC"}

package/dist/services/system/ToolDenylist.js

@@ -0,0 +1,85 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const DEFAULT_DENYLIST = ["gpt-creator"];
+const DEFAULT_ALTERNATIVES = new Map([
+    ["gpt-creator", ["codex", "local-model"]],
+]);
+const parseDelimitedList = (value) => {
+    if (!value)
+        return [];
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+};
+const normalizeToolName = (value) => value.trim().toLowerCase();
+const parseConfigList = (value) => {
+    if (!value)
+        return [];
+    if (Array.isArray(value)) {
+        return value.filter((entry) => typeof entry === "string");
+    }
+    if (typeof value === "string") {
+        return parseDelimitedList(value);
+    }
+    return [];
+};
+const readConfigDenylist = async (mcodaDir) => {
+    if (!mcodaDir)
+        return [];
+    const configPath = path.join(mcodaDir, "config.json");
+    try {
+        const raw = await fs.readFile(configPath, "utf8");
+        const parsed = JSON.parse(raw);
+        const configured = parsed?.tools?.denylist ??
+            parsed?.toolDenylist ??
+            parsed?.tool_denylist;
+        return parseConfigList(configured);
+    }
+    catch {
+        return [];
+    }
+};
+export class ToolDenylist {
+    constructor(entries) {
+        this.entries = entries;
+    }
+    static async load(options = {}) {
+        const env = options.env ?? process.env;
+        const configEntries = await readConfigDenylist(options.mcodaDir);
+        const envEntries = parseDelimitedList(env.MCODA_TOOL_DENYLIST);
+        const combined = [...DEFAULT_DENYLIST, ...configEntries, ...envEntries];
+        const entries = new Map();
+        for (const name of combined) {
+            const normalized = normalizeToolName(name);
+            if (!normalized || entries.has(normalized))
+                continue;
+            entries.set(normalized, DEFAULT_ALTERNATIVES.get(normalized) ?? []);
+        }
+        return new ToolDenylist(entries);
+    }
+    list() {
+        return Array.from(this.entries.keys());
+    }
+    match(name) {
+        const normalized = normalizeToolName(name);
+        return this.entries.has(normalized) ? normalized : undefined;
+    }
+    findMatch(names) {
+        for (const name of names) {
+            if (!name)
+                continue;
+            const match = this.match(name);
+            if (match)
+                return match;
+        }
+        return undefined;
+    }
+    formatViolation(matched) {
+        const alternatives = this.entries.get(matched) ?? [];
+        const suggestion = alternatives.length
+            ? `Suggested alternatives: ${alternatives.join(", ")}.`
+            : "Use a supported agent or tool instead.";
+        return `Tool '${matched}' is deprecated and blocked by the tool denylist. ${suggestion}`;
+    }
+}

package/dist/services/tasks/TaskCommentFormatter.d.ts

@@ -0,0 +1,20 @@
+export interface TaskCommentSlugInput {
+    source: string;
+    message: string;
+    file?: string | null;
+    line?: number | null;
+    category?: string | null;
+}
+export interface TaskCommentFormatInput {
+    slug: string;
+    source: string;
+    message: string;
+    status?: string | null;
+    category?: string | null;
+    file?: string | null;
+    line?: number | null;
+    suggestedFix?: string | null;
+}
+export declare const createTaskCommentSlug: (input: TaskCommentSlugInput) => string;
+export declare const formatTaskCommentBody: (input: TaskCommentFormatInput) => string;
+//# sourceMappingURL=TaskCommentFormatter.d.ts.map

package/dist/services/tasks/TaskCommentFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskCommentFormatter.d.ts","sourceRoot":"","sources":["../../../src/services/tasks/TaskCommentFormatter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAiBD,eAAO,MAAM,qBAAqB,GAAI,OAAO,oBAAoB,KAAG,MAiBnE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,sBAAsB,KAAG,MAyBrE,CAAC"}

package/dist/services/tasks/TaskCommentFormatter.js

@@ -0,0 +1,54 @@
+import { createHash } from "node:crypto";
+const slugify = (value) => value
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .replace(/-{2,}/g, "-");
+const normalizePath = (value) => value
+    .replace(/\\/g, "/")
+    .replace(/^\.\//, "")
+    .replace(/^\/+/, "");
+const buildStableHash = (input) => createHash("sha1").update(input).digest("hex").slice(0, 8);
+export const createTaskCommentSlug = (input) => {
+    const baseParts = [
+        input.source,
+        input.category ?? undefined,
+        input.file ? normalizePath(input.file) : undefined,
+        typeof input.line === "number" ? `L${input.line}` : undefined,
+    ].filter(Boolean);
+    const base = slugify(baseParts.join("-")) || "comment";
+    const trimmedBase = base.length > 60 ? base.slice(0, 60).replace(/-+$/g, "") : base;
+    const hashInput = [
+        input.source,
+        input.category ?? "",
+        input.file ?? "",
+        typeof input.line === "number" ? String(input.line) : "",
+        input.message.trim(),
+    ].join("|");
+    return `${trimmedBase || "comment"}-${buildStableHash(hashInput)}`;
+};
+export const formatTaskCommentBody = (input) => {
+    const message = input.message.trim() || "(no details provided)";
+    const suggestedFix = input.suggestedFix?.trim();
+    const location = input.file && typeof input.line === "number"
+        ? `${normalizePath(input.file)}:${input.line}`
+        : input.file
+            ? normalizePath(input.file)
+            : undefined;
+    const lines = [
+        "[task-comment]",
+        `slug: ${input.slug}`,
+        `source: ${input.source}`,
+        input.category ? `category: ${input.category}` : undefined,
+        `status: ${input.status ?? "open"}`,
+        location ? `location: ${location}` : undefined,
+        "message:",
+        message,
+    ].filter(Boolean);
+    if (suggestedFix) {
+        lines.push("");
+        lines.push("suggested_fix:");
+        lines.push(suggestedFix);
+    }
+    return lines.join("\n");
+};

package/dist/services/telemetry/TelemetryService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TelemetryService.d.ts","sourceRoot":"","sources":["../../../src/services/telemetry/TelemetryService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,aAAa,EAAE,oBAAoB,EAAE,KAAK,eAAe,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACvI,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,KAAK,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7F,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0FD,qBAAa,gBAAgB;IAMP,OAAO,CAAC,SAAS;IALrC,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,EAAE,CAAC,CAAW;IACtB,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC,OAAO;WAMM,MAAM,CACjB,SAAS,EAAE,mBAAmB,EAC9B,OAAO,GAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACtE,OAAO,CAAC,gBAAgB,CAAC;IA6BtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,KAAK,UAAU,GAErB;YAEa,cAAc;YASd,eAAe;YAKf,gBAAgB;YAMhB,aAAa;YAOb,cAAc;IAc5B,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,SAAS;IAWX,UAAU,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA6GlF,aAAa,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAuG7E,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAqB1C,MAAM,CAAC,MAAM,UAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAerD,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAc7C"}
+{"version":3,"file":"TelemetryService.d.ts","sourceRoot":"","sources":["../../../src/services/telemetry/TelemetryService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,aAAa,EAAE,oBAAoB,EAAE,KAAK,eAAe,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACvI,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,KAAK,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7F,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqGD,qBAAa,gBAAgB;IAMP,OAAO,CAAC,SAAS;IALrC,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAkB;IACjC,OAAO,CAAC,EAAE,CAAC,CAAW;IACtB,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC,OAAO;WAMM,MAAM,CACjB,SAAS,EAAE,mBAAmB,EAC9B,OAAO,GAAE;QAAE,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACtE,OAAO,CAAC,gBAAgB,CAAC;IA6BtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,KAAK,UAAU,GAErB;YAEa,cAAc;YASd,eAAe;YAKf,gBAAgB;YAMhB,aAAa;YAOb,cAAc;IAc5B,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,SAAS;IAWX,UAAU,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IA+HlF,aAAa,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAwH7E,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAqB1C,MAAM,CAAC,MAAM,UAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAerD,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAc7C"}

package/dist/services/telemetry/TelemetryService.js

@@ -161,7 +161,8 @@ export class TelemetryService {
         const filtered = [];
         for (const row of rows) {
             const metadata = parseMetadata(row.metadata_json);
-            const commandName = metadata.commandName ??
+            const commandName = row.command_name ??
+                metadata.commandName ??
                 metadata.command_name ??
                 metadata.command;
             if (options.command && commandName && options.command !== commandName) {
@@ -232,11 +233,15 @@ export class TelemetryService {
         const filtered = this.filterRows(rows, { command: options.command });
         const summary = new Map();
         for (const { row, metadata } of filtered) {
-            const commandName = metadata.commandName ??
+            const commandName = row.command_name ??
+                metadata.commandName ??
                 metadata.command_name ??
                 metadata.command ??
                 null;
-            const action = metadata.action ?? metadata.phase ?? null;
+            const action = row.action ??
+                metadata.action ??
+                metadata.phase ??
+                null;
             const keyParts = groupBy.map((dim) => {
                 switch (dim) {
                     case "project":
@@ -273,6 +278,10 @@ export class TelemetryService {
                     tokens_prompt: 0,
                     tokens_completion: 0,
                     tokens_total: 0,
+                    tokens_cached: 0,
+                    tokens_cache_read: 0,
+                    tokens_cache_write: 0,
+                    duration_ms: 0,
                     cost_estimate: null,
                 };
                 summary.set(key, record);
@@ -281,6 +290,14 @@ export class TelemetryService {
             record.tokens_prompt += row.tokens_prompt ?? 0;
             record.tokens_completion += row.tokens_completion ?? 0;
             record.tokens_total += row.tokens_total ?? 0;
+            record.tokens_cached = (record.tokens_cached ?? 0) + (row.tokens_cached ?? 0);
+            record.tokens_cache_read = (record.tokens_cache_read ?? 0) + (row.tokens_cache_read ?? 0);
+            record.tokens_cache_write = (record.tokens_cache_write ?? 0) + (row.tokens_cache_write ?? 0);
+            const durationMs = row.duration_ms ??
+                (row.duration_seconds != null ? Math.round(row.duration_seconds * 1000) : null);
+            if (durationMs != null) {
+                record.duration_ms = (record.duration_ms ?? 0) + durationMs;
+            }
             record.cost_estimate = addCost(record.cost_estimate, row.cost_estimate);
         }
         return Array.from(summary.values());
@@ -338,15 +355,21 @@ export class TelemetryService {
         const filtered = this.filterRows(rows, { command: options.command });
         const mapped = filtered
             .map(({ row, metadata }) => {
-            const commandName = metadata.commandName ??
+            const commandName = row.command_name ??
+                metadata.commandName ??
                 metadata.command_name ??
                 metadata.command ??
                 null;
-            const action = metadata.action ?? metadata.phase ?? null;
+            const action = row.action ??
+                metadata.action ??
+                metadata.phase ??
+                null;
             const errorKind = metadata.error_kind ??
                 metadata.errorKind ??
                 metadata.error ??
                 null;
+            const durationMs = row.duration_ms ??
+                (row.duration_seconds != null ? Math.round(row.duration_seconds * 1000) : null);
             return {
                 workspace_id: row.workspace_id,
                 agent_id: row.agent_id,
@@ -358,14 +381,23 @@ export class TelemetryService {
                 project_id: row.project_id,
                 epic_id: row.epic_id,
                 user_story_id: row.user_story_id,
+                command_name: commandName,
+                action,
+                invocation_kind: row.invocation_kind ?? null,
+                provider: row.provider ?? null,
+                currency: row.currency ?? null,
                 tokens_prompt: row.tokens_prompt,
                 tokens_completion: row.tokens_completion,
                 tokens_total: row.tokens_total,
+                tokens_cached: row.tokens_cached ?? null,
+                tokens_cache_read: row.tokens_cache_read ?? null,
+                tokens_cache_write: row.tokens_cache_write ?? null,
                 cost_estimate: row.cost_estimate,
                 duration_seconds: row.duration_seconds,
+                duration_ms: durationMs ?? null,
+                started_at: row.started_at ?? null,
+                finished_at: row.finished_at ?? null,
                 timestamp: row.timestamp,
-                command_name: commandName,
-                action,
                 error_kind: errorKind,
                 metadata,
             };

package/dist/workspace/WorkspaceManager.d.ts

@@ -6,6 +6,7 @@ export interface WorkspaceResolution {
     mcodaDir: string;
     workspaceDbPath: string;
     globalDbPath: string;
+    noRepoWrites?: boolean;
     config?: WorkspaceConfig;
 }
 export interface TelemetryPreferences {
@@ -18,6 +19,17 @@ export interface WorkspaceConfig {
     mirrorDocs?: boolean;
     branch?: string;
     docdexUrl?: string;
+    docdexRepoId?: string;
+    reviewJsonAgent?: string;
+    projectKey?: string;
+    restrictAutoMergeWithoutScope?: boolean;
+    autoMerge?: boolean;
+    autoPush?: boolean;
+    codexNoSandbox?: boolean;
+    qa?: {
+        cleanIgnorePaths?: string[];
+        runAllMarkerRequired?: boolean;
+    };
     velocity?: {
         implementationSpPerHour?: number;
         reviewSpPerHour?: number;
@@ -26,10 +38,24 @@ export interface WorkspaceConfig {
     };
     telemetry?: TelemetryPreferences;
 }
+export declare const cleanupWorkspaceStateDirs: (input: {
+    workspaceRoot: string;
+    mcodaDir: string;
+}) => Promise<string[]>;
+export declare const resolveDocgenStatePath: (input: {
+    outputPath: string;
+    mcodaDir: string;
+    jobId: string;
+    commandName: string;
+}) => {
+    statePath: string;
+    warnings: string[];
+};
 export declare class WorkspaceResolver {
     static resolveWorkspace(input: {
         cwd?: string;
         explicitWorkspace?: string;
+        noRepoWrites?: boolean;
     }): Promise<WorkspaceResolution>;
 }
 //# sourceMappingURL=WorkspaceManager.d.ts.map