@principles/core 1.75.0 → 1.77.0

package/dist/runtime-v2/feedback/create-report.js

@@ -0,0 +1,257 @@
+// create-report.ts
+// Orchestrator: validate input → collect diagnostics → redact → render.
+// ERR-001/005/013: no `as` casts on untrusted input.
+// ERR-002: failure paths return {ok: false, errors: ValidationError[]}; success returns {ok: true, report: FeedbackReport}.
+// ERR-003: redaction uses segment-exact key matching (handled by redact-sensitive).
+// ERR-014/016/017: bounded previews, BigInt-safe safeStringifyPreview.
+import { isRecord, isString, isUserSeverity, normalizeFeedbackDraftInput, } from './feedback-types.js';
+import { redactAbsolutePaths, redactTokenLikeValues, redactEnvLikeValues, redactSensitiveFields, } from './redact-sensitive.js';
+import { renderReportMarkdown } from './render-markdown.js';
+import { buildGitHubIssueDraftUrl } from './render-github-url.js';
+import { buildPrivacyPreview, buildEmailText } from './privacy-preview.js';
+const MAX_DESCRIPTION_FOR_REDACT = 8000;
+const MAX_STEPS_FOR_REDACT = 8000;
+const MAX_CONTEXT_REFS = 12;
+const MAX_REDACTION_NOTES = 20;
+function generateReportId() {
+    try {
+        if (typeof globalThis.crypto !== 'undefined' && typeof globalThis.crypto.randomUUID === 'function') {
+            return 'fb-' + globalThis.crypto.randomUUID();
+        }
+    }
+    catch {
+        // Fallback below
+    }
+    const ts = Date.now().toString(36);
+    const rand = Math.random().toString(36).slice(2, 8);
+    return 'fb-' + ts + '-' + rand;
+}
+function applyUserTextRedactions(text) {
+    if (typeof text !== 'string')
+        return '';
+    let out = text;
+    if (out.length > MAX_DESCRIPTION_FOR_REDACT) {
+        out = out.slice(0, MAX_DESCRIPTION_FOR_REDACT);
+    }
+    out = redactAbsolutePaths(out);
+    out = redactTokenLikeValues(out);
+    out = redactEnvLikeValues(out);
+    return out;
+}
+function applyStepsRedactions(text) {
+    if (typeof text !== 'string')
+        return undefined;
+    let out = text;
+    if (out.length > MAX_STEPS_FOR_REDACT) {
+        out = out.slice(0, MAX_STEPS_FOR_REDACT);
+    }
+    out = redactAbsolutePaths(out);
+    out = redactTokenLikeValues(out);
+    out = redactEnvLikeValues(out);
+    return out;
+}
+function pushContextRef(refs, kind, args) {
+    if (refs.length >= MAX_CONTEXT_REFS)
+        return;
+    if (typeof args.id !== 'string' || args.id.length === 0)
+        return;
+    const r = { kind, id: args.id };
+    if (typeof args.label === 'string' && args.label.length > 0)
+        r.label = args.label;
+    refs.push(r);
+}
+function pickString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+/**
+ * Build a DiagnosticSummary from an unknown diagnostics value.
+ * Always returns a valid DiagnosticSummary. Records `unavailableReason` for
+ * unparseable versions/feature flags/canary — never throws.
+ */
+function collectDiagnostics(diagnostics) {
+    if (!isRecord(diagnostics)) {
+        return {
+            versions: { unavailableReason: 'diagnostics not provided' },
+            platform: { unavailableReason: 'diagnostics not provided' },
+            featureFlags: { unavailableReason: 'diagnostics not provided' },
+            canary: { status: 'unavailable', unavailableReason: 'diagnostics not provided' },
+            recentEvents: [],
+        };
+    }
+    // versions
+    let versions = { unavailableReason: 'versions not available' };
+    if (Object.hasOwn(diagnostics, 'versions') && isRecord(diagnostics.versions)) {
+        versions = { ...diagnostics.versions };
+    }
+    // platform
+    let platform = { unavailableReason: 'platform not available' };
+    if (Object.hasOwn(diagnostics, 'platform') && isRecord(diagnostics.platform)) {
+        platform = { ...diagnostics.platform };
+    }
+    // featureFlags
+    let featureFlags = { unavailableReason: 'feature flags not available' };
+    if (Object.hasOwn(diagnostics, 'featureFlags') && isRecord(diagnostics.featureFlags)) {
+        featureFlags = { ...diagnostics.featureFlags };
+    }
+    // canary
+    let canary = { status: 'unavailable', unavailableReason: 'canary not available' };
+    if (Object.hasOwn(diagnostics, 'canary') && isRecord(diagnostics.canary)) {
+        const c = diagnostics.canary;
+        if (Object.hasOwn(c, 'status') && (c.status === 'available' || c.status === 'unavailable')) {
+            const { status } = c;
+            const built = { status };
+            if (status === 'available') {
+                if (isString(c.summary))
+                    built.summary = c.summary;
+            }
+            else {
+                if (isString(c.unavailableReason))
+                    built.unavailableReason = c.unavailableReason;
+                else
+                    built.unavailableReason = 'canary reported unavailable';
+            }
+            canary = built;
+        }
+    }
+    // recentEvents
+    let recentEvents = [];
+    if (Object.hasOwn(diagnostics, 'recentEvents') && Array.isArray(diagnostics.recentEvents)) {
+        const arr = diagnostics.recentEvents;
+        for (const e of arr) {
+            if (!isRecord(e))
+                continue;
+            const evType = pickString(e.type);
+            const evSummary = pickString(e.summary);
+            const evAt = pickString(e.at);
+            if (!evType || !evSummary || !evAt)
+                continue;
+            const ev = { type: evType, at: evAt, summary: evSummary };
+            const sev = pickString(e.severity);
+            if (sev)
+                ev.severity = sev;
+            recentEvents.push(ev);
+        }
+    }
+    return { versions, platform, featureFlags, canary, recentEvents };
+}
+/**
+ * Create a FeedbackReport from untrusted input + diagnostics.
+ * No `as` casts on untrusted values. Failure paths return structured errors.
+ */
+export function createFeedbackReport(input, diagnostics) {
+    // Step 1: validate and normalize the input
+    const norm = normalizeFeedbackDraftInput(input);
+    if (!norm.ok) {
+        return { ok: false, errors: norm.errors };
+    }
+    const draft = norm.value;
+    // Step 2: collect diagnostics (never throws; missing diagnostics produce
+    // structured unavailable entries, not errors)
+    const diagnosticSummary = collectDiagnostics(diagnostics);
+    // Step 3: redact the user-provided text fields
+    const redactionNotes = [];
+    const description = applyUserTextRedactions(draft.userText.description);
+    if (description !== draft.userText.description)
+        redactionNotes.push('description was redacted (paths/tokens/env values)');
+    const stepsInput = draft.userText.stepsToReproduce;
+    const stepsToReproduce = typeof stepsInput === 'string' ? applyStepsRedactions(stepsInput) : undefined;
+    if (typeof stepsInput === 'string' && stepsToReproduce !== stepsInput) {
+        redactionNotes.push('stepsToReproduce was redacted (paths/tokens/env values)');
+    }
+    const expectedInput = draft.userText.expectedBehavior;
+    const expectedBehavior = typeof expectedInput === 'string'
+        ? redactAbsolutePaths(redactTokenLikeValues(redactEnvLikeValues(expectedInput)))
+        : undefined;
+    if (typeof expectedInput === 'string' && expectedBehavior !== expectedInput) {
+        redactionNotes.push('expectedBehavior was redacted');
+    }
+    const actualInput = draft.userText.actualBehavior;
+    const actualBehavior = typeof actualInput === 'string'
+        ? redactAbsolutePaths(redactTokenLikeValues(redactEnvLikeValues(actualInput)))
+        : undefined;
+    if (typeof actualInput === 'string' && actualBehavior !== actualInput) {
+        redactionNotes.push('actualBehavior was redacted');
+    }
+    // Step 4: scrub the diagnosticSummary via redactSensitiveFields (defense in
+    // depth — versions and platform should already be low-sensitivity, but
+    // user-injected values must not leak tokens through the field structure).
+    const scrubbed = redactSensitiveFields(diagnosticSummary);
+    const safeDiagnostic = scrubbed.ok
+        ? scrubbed.value
+        : diagnosticSummary;
+    if (scrubbed.ok) {
+        for (const n of scrubbed.notes) {
+            if (redactionNotes.length < MAX_REDACTION_NOTES)
+                redactionNotes.push(n);
+        }
+    }
+    // Step 5: redact the title for the URL (but keep the original title in the
+    // report itself so the user can read what they wrote)
+    const redactedTitle = redactAbsolutePaths(redactTokenLikeValues(draft.title));
+    // Step 6: build contextRefs from the context object
+    const contextRefs = [];
+    if (draft.context) {
+        pushContextRef(contextRefs, 'source', { id: draft.context.source, label: `source=${draft.context.source}` });
+        pushContextRef(contextRefs, 'page', { id: draft.context.page });
+        pushContextRef(contextRefs, 'painId', { id: draft.context.painId });
+        pushContextRef(contextRefs, 'principleId', { id: draft.context.principleId });
+        pushContextRef(contextRefs, 'approvalId', { id: draft.context.approvalId });
+        pushContextRef(contextRefs, 'activationId', { id: draft.context.activationId });
+        pushContextRef(contextRefs, 'updateAttemptId', { id: draft.context.updateAttemptId });
+    }
+    if (draft.agentDraft) {
+        pushContextRef(contextRefs, 'agentDraft', { id: 'present', label: 'agentDraft attached' });
+    }
+    // Step 7: build the privacy preview
+    const privacy = buildPrivacyPreview(redactionNotes);
+    // Step 8: assemble the report
+    const userText = { description };
+    if (stepsToReproduce !== undefined)
+        userText.stepsToReproduce = stepsToReproduce;
+    if (draft.userText.expectedBehavior !== undefined)
+        userText.expectedBehavior = expectedBehavior;
+    if (draft.userText.actualBehavior !== undefined)
+        userText.actualBehavior = actualBehavior;
+    if (isUserSeverity(draft.userText.userSeverity))
+        userText.userSeverity = draft.userText.userSeverity;
+    const id = generateReportId();
+    const createdAt = new Date().toISOString();
+    // Step 9: render markdown and email text. Renderers mutate privacy.redactionNotes
+    // if they truncate; that's intentional and observable.
+    const report = {
+        id,
+        createdAt,
+        type: draft.type,
+        title: draft.title,
+        userText,
+        diagnosticSummary: safeDiagnostic,
+        contextRefs,
+        privacy,
+        outputs: { markdown: '', emailText: '', githubIssueUrl: '' },
+    };
+    // Surface the agent-attached evidence in the report so it propagates to
+    // markdown, emailText, and any later consumer.
+    // Redact sensitive values (paths/tokens/env) from agentDraft string fields.
+    if (draft.agentDraft) {
+        const ad = draft.agentDraft;
+        report.agentDraft = {
+            summary: redactEnvLikeValues(redactAbsolutePaths(redactTokenLikeValues(ad.summary))),
+        };
+        if (ad.observedFailure) {
+            report.agentDraft.observedFailure = redactEnvLikeValues(redactAbsolutePaths(redactTokenLikeValues(ad.observedFailure)));
+        }
+        if (ad.commandSummary) {
+            report.agentDraft.commandSummary = redactEnvLikeValues(redactAbsolutePaths(redactTokenLikeValues(ad.commandSummary)));
+        }
+        redactionNotes.push('agentDraft fields were redacted (paths/tokens/env values)');
+    }
+    report.outputs.markdown = renderReportMarkdown(report);
+    report.outputs.emailText = buildEmailText(report);
+    // Step 10: build the bounded GitHub issue draft URL using only the redacted
+    // title and a short summary (description truncated to 200 chars).
+    const shortSummary = `type=${draft.type}; ${description.slice(0, 200)}`;
+    const urlResult = buildGitHubIssueDraftUrl(redactedTitle, draft.type, shortSummary);
+    report.outputs.githubIssueUrl = urlResult.ok ? urlResult.url : '';
+    return { ok: true, report };
+}
+//# sourceMappingURL=create-report.js.map

package/dist/runtime-v2/feedback/create-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-report.js","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/create-report.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,wEAAwE;AACxE,qDAAqD;AACrD,4HAA4H;AAC5H,oFAAoF;AACpF,uEAAuE;AAWvE,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3E,MAAM,0BAA0B,GAAG,IAAI,CAAC;AACxC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,WAAW,IAAI,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACnG,OAAO,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,KAAK,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAwB;IACvD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,IAAI,GAAG,CAAC,MAAM,GAAG,0BAA0B,EAAE,CAAC;QAC5C,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACjD,CAAC;IACD,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/B,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACjC,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAwB;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,IAAI,GAAG,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QACtC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC3C,CAAC;IACD,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/B,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACjC,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC;AAID,SAAS,cAAc,CAAC,IAAkB,EAAE,IAAY,EAAE,IAAiD;IACzG,IAAI,IAAI,CAAC,MAAM,IAAI,gBAAgB;QAAE,OAAO;IAC5C,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAChE,MAAM,CAAC,GAAe,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IAC5C,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAClF,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,WAAoB;IAC9C,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE,EAAE,iBAAiB,EAAE,0BAA0B,EAAE;YAC3D,QAAQ,EAAE,EAAE,iBAAiB,EAAE,0BAA0B,EAAE;YAC3D,YAAY,EAAE,EAAE,iBAAiB,EAAE,0BAA0B,EAAE;YAC/D,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,0BAA0B,EAAE;YAChF,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,WAAW;IACX,IAAI,QAAQ,GAA4B,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;IACxF,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7E,QAAQ,GAAG,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,WAAW;IACX,IAAI,QAAQ,GAA4B,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC;IACxF,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7E,QAAQ,GAAG,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,eAAe;IACf,IAAI,YAAY,GAA4B,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,CAAC;IACjG,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QACrF,YAAY,GAAG,EAAE,GAAG,WAAW,CAAC,YAAY,EAAE,CAAC;IACjD,CAAC;IAED,SAAS;IACT,IAAI,MAAM,GAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAChG,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACzE,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,EAAE,CAAC;YAC3F,MAAM,EAAC,MAAM,EAAC,GAAG,CAAC,CAAC;YACnB,MAAM,KAAK,GAAiB,EAAE,MAAM,EAAE,CAAC;YACvC,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC3B,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;oBAAE,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,IAAI,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC;oBAAE,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,iBAAiB,CAAC;;oBAC5E,KAAK,CAAC,iBAAiB,GAAG,6BAA6B,CAAC;YAC/D,CAAC;YACD,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,YAAY,GAAkB,EAAE,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1F,MAAM,GAAG,GAAG,WAAW,CAAC,YAAyB,CAAC;QAClD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC3B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI;gBAAE,SAAS;YAC7C,MAAM,EAAE,GAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YACvE,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,GAAG;gBAAE,EAAE,CAAC,QAAQ,GAAG,GAAG,CAAC;YAC3B,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,WAAoB;IAEpB,2CAA2C;IAC3C,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,KAAK,GAAoB,IAAI,CAAC,KAAK,CAAC;IAE1C,yEAAyE;IACzE,8CAA8C;IAC9C,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAE1D,+CAA+C;IAC/C,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACxE,IAAI,WAAW,KAAK,KAAK,CAAC,QAAQ,CAAC,WAAW;QAAE,cAAc,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IAC1H,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACnD,MAAM,gBAAgB,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACtE,cAAc,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IACtD,MAAM,gBAAgB,GAAG,OAAO,aAAa,KAAK,QAAQ;QACxD,CAAC,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,gBAAgB,KAAK,aAAa,EAAE,CAAC;QAC5E,cAAc,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;IAClD,MAAM,cAAc,GAAG,OAAO,WAAW,KAAK,QAAQ;QACpD,CAAC,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;QACtE,cAAc,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACrD,CAAC;IAED,4EAA4E;IAC5E,uEAAuE;IACvE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAsB,QAAQ,CAAC,EAAE;QACnD,CAAC,CAAE,QAAQ,CAAC,KAA2B;QACvC,CAAC,CAAC,iBAAiB,CAAC;IACtB,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,cAAc,CAAC,MAAM,GAAG,mBAAmB;gBAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,sDAAsD;IACtD,MAAM,aAAa,GAAG,mBAAmB,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAE9E,oDAAoD;IACpD,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7G,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACpE,cAAc,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9E,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5E,cAAc,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAChF,cAAc,CAAC,WAAW,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,cAAc,CAAC,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,oCAAoC;IACpC,MAAM,OAAO,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;IAEpD,8BAA8B;IAC9B,MAAM,QAAQ,GAA+B,EAAE,WAAW,EAAE,CAAC;IAC7D,IAAI,gBAAgB,KAAK,SAAS;QAAE,QAAQ,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IACjF,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,KAAK,SAAS;QAAE,QAAQ,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAChG,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,KAAK,SAAS;QAAE,QAAQ,CAAC,cAAc,GAAG,cAAc,CAAC;IAC1F,IAAI,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;IAErG,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,kFAAkF;IAClF,uDAAuD;IACvD,MAAM,MAAM,GAAmB;QAC7B,EAAE;QACF,SAAS;QACT,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ;QACR,iBAAiB,EAAE,cAAc;QACjC,WAAW;QACX,OAAO;QACP,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;KAC7D,CAAC;IACF,wEAAwE;IACxE,+CAA+C;IAC/C,4EAA4E;IAC5E,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC;QAC5B,MAAM,CAAC,UAAU,GAAG;YAClB,OAAO,EAAE,mBAAmB,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;SACrF,CAAC;QACF,IAAI,EAAE,CAAC,eAAe,EAAE,CAAC;YACvB,MAAM,CAAC,UAAU,CAAC,eAAe,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1H,CAAC;QACD,IAAI,EAAE,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,CAAC,UAAU,CAAC,cAAc,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACxH,CAAC;QACD,cAAc,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,CAAC,OAAO,CAAC,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAElD,4EAA4E;IAC5E,kEAAkE;IAClE,MAAM,YAAY,GAAG,QAAQ,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACxE,MAAM,SAAS,GAAG,wBAAwB,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpF,MAAM,CAAC,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/runtime-v2/feedback/feedback-types.d.ts

@@ -0,0 +1,120 @@
+export type FeedbackType = 'bug' | 'confusing' | 'privacy_concern' | 'feature_request' | 'other';
+export type UserSeverity = 'low' | 'medium' | 'high';
+export type FeedbackSource = 'console' | 'cli' | 'agent';
+export interface FeedbackContext {
+    source: FeedbackSource;
+    page?: string;
+    painId?: string;
+    principleId?: string;
+    approvalId?: string;
+    activationId?: string;
+    updateAttemptId?: string;
+}
+export interface AgentDraft {
+    summary: string;
+    observedFailure?: string;
+    commandSummary?: string;
+}
+export interface FeedbackUserText {
+    description: string;
+    stepsToReproduce?: string;
+    expectedBehavior?: string;
+    actualBehavior?: string;
+    userSeverity?: UserSeverity;
+}
+/**
+ * The contract input: every field is typed as `unknown` because the input
+ * comes from untrusted sources (Console form, CLI, agent, or HTTP body).
+ * Callers must pass the value through `normalizeFeedbackDraftInput` before
+ * any other code touches the fields.
+ */
+export interface FeedbackDraftInput {
+    type: unknown;
+    title: unknown;
+    description: unknown;
+    stepsToReproduce?: unknown;
+    expectedBehavior?: unknown;
+    actualBehavior?: unknown;
+    userSeverity?: unknown;
+    context?: unknown;
+    agentDraft?: unknown;
+}
+/**
+ * The narrowed shape returned by `normalizeFeedbackDraftInput` on success.
+ * Safe to use throughout the rest of the pipeline.
+ */
+export interface NormalizedDraft {
+    type: FeedbackType;
+    title: string;
+    userText: FeedbackUserText;
+    context?: FeedbackContext;
+    agentDraft?: AgentDraft;
+}
+export interface RecentEvent {
+    type: string;
+    at: string;
+    severity?: string;
+    summary: string;
+}
+export interface CanaryStatus {
+    status: 'available' | 'unavailable';
+    summary?: string;
+    unavailableReason?: string;
+}
+export interface DiagnosticSummary {
+    versions: Record<string, unknown>;
+    platform: Record<string, unknown>;
+    featureFlags: Record<string, unknown>;
+    canary: CanaryStatus;
+    recentEvents: RecentEvent[];
+}
+export interface ContextRef {
+    kind: string;
+    id: string;
+    label?: string;
+}
+export interface PrivacyPreview {
+    includedSections: string[];
+    excludedByDefault: string[];
+    redactionNotes: string[];
+}
+export interface FeedbackReport {
+    id: string;
+    createdAt: string;
+    type: FeedbackType;
+    title: string;
+    userText: FeedbackUserText;
+    agentDraft?: AgentDraft;
+    diagnosticSummary: DiagnosticSummary;
+    contextRefs: ContextRef[];
+    privacy: PrivacyPreview;
+    outputs: {
+        markdown: string;
+        emailText: string;
+        githubIssueUrl: string;
+    };
+}
+export type ValidationError = {
+    field: string;
+    reason: string;
+    nextAction: string;
+};
+export type NormalizeResult = {
+    ok: true;
+    value: NormalizedDraft;
+} | {
+    ok: false;
+    errors: ValidationError[];
+};
+export declare function isFeedbackType(value: unknown): value is FeedbackType;
+export declare function isUserSeverity(value: unknown): value is UserSeverity;
+export declare function isFeedbackSource(value: unknown): value is FeedbackSource;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isBoolean(value: unknown): value is boolean;
+export { isString } from './internal-guards.js';
+/**
+ * Validate and normalize a `FeedbackDraftInput` value.
+ * Returns a discriminated union. Never throws.
+ */
+export declare function normalizeFeedbackDraftInput(value: unknown): NormalizeResult;
+//# sourceMappingURL=feedback-types.d.ts.map

package/dist/runtime-v2/feedback/feedback-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-types.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/feedback/feedback-types.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/feedback/feedback-types.js

@@ -0,0 +1,243 @@
+// feedback-types.ts
+// Core type definitions and runtime validators for the feedback report contract.
+// ERR-001/005/013: no `as` casts on untrusted input. All validation uses typeof + Object.hasOwn + isRecord.
+// ERR-002: failure paths include reason + nextAction.
+import { isString } from './internal-guards.js';
+// ── Type guards ──────────────────────────────────────────────────────────────
+const FEEDBACK_TYPES = [
+    'bug',
+    'confusing',
+    'privacy_concern',
+    'feature_request',
+    'other',
+];
+const USER_SEVERITIES = ['low', 'medium', 'high'];
+const FEEDBACK_SOURCES = ['console', 'cli', 'agent'];
+export function isFeedbackType(value) {
+    return typeof value === 'string' && FEEDBACK_TYPES.includes(value);
+}
+export function isUserSeverity(value) {
+    return typeof value === 'string' && USER_SEVERITIES.includes(value);
+}
+export function isFeedbackSource(value) {
+    return typeof value === 'string' && FEEDBACK_SOURCES.includes(value);
+}
+export function isRecord(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (Array.isArray(value))
+        return false;
+    return true;
+}
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+// Re-export the shared isString guard so callers can import everything from one place.
+export { isString } from './internal-guards.js';
+// ── Validators (return ValidationError[]; do not throw) ──────────────────────
+function validateOptionalString(value, field, errors) {
+    if (value === undefined)
+        return undefined;
+    if (!isString(value)) {
+        errors.push({
+            field,
+            reason: `${field} must be a string when provided (ERR-010)`,
+            nextAction: `provide a string value for ${field} or omit it`,
+        });
+        return undefined;
+    }
+    return value;
+}
+function validateFeedbackContext(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        errors.push({
+            field: 'context',
+            reason: 'context must be a non-null object when provided',
+            nextAction: 'provide a valid context object or omit it',
+        });
+        return errors;
+    }
+    if (!Object.hasOwn(value, 'source')) {
+        errors.push({
+            field: 'context.source',
+            reason: 'context.source is required when context is provided (ERR-009)',
+            nextAction: 'add context.source with a value of console, cli, or agent',
+        });
+    }
+    else if (!isFeedbackSource(value.source)) {
+        errors.push({
+            field: 'context.source',
+            reason: 'context.source must be one of: console, cli, agent (ERR-010)',
+            nextAction: 'set context.source to a valid FeedbackSource value',
+        });
+    }
+    validateOptionalString(value.page, 'context.page', errors);
+    validateOptionalString(value.painId, 'context.painId', errors);
+    validateOptionalString(value.principleId, 'context.principleId', errors);
+    validateOptionalString(value.approvalId, 'context.approvalId', errors);
+    validateOptionalString(value.activationId, 'context.activationId', errors);
+    validateOptionalString(value.updateAttemptId, 'context.updateAttemptId', errors);
+    return errors;
+}
+function validateAgentDraft(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        errors.push({
+            field: 'agentDraft',
+            reason: 'agentDraft must be a non-null object when provided',
+            nextAction: 'provide a valid agentDraft object or omit it',
+        });
+        return errors;
+    }
+    if (!Object.hasOwn(value, 'summary')) {
+        errors.push({
+            field: 'agentDraft.summary',
+            reason: 'agentDraft.summary is required when agentDraft is provided (ERR-009)',
+            nextAction: 'add a summary field to agentDraft',
+        });
+    }
+    else if (!isString(value.summary)) {
+        errors.push({
+            field: 'agentDraft.summary',
+            reason: 'agentDraft.summary must be a string (ERR-010)',
+            nextAction: 'provide a string value for agentDraft.summary',
+        });
+    }
+    validateOptionalString(value.observedFailure, 'agentDraft.observedFailure', errors);
+    validateOptionalString(value.commandSummary, 'agentDraft.commandSummary', errors);
+    return errors;
+}
+/**
+ * Validate and normalize a `FeedbackDraftInput` value.
+ * Returns a discriminated union. Never throws.
+ */
+export function normalizeFeedbackDraftInput(value) {
+    const errors = [];
+    if (!isRecord(value)) {
+        errors.push({
+            field: 'root',
+            reason: 'feedback input must be a non-null object',
+            nextAction: 'provide a valid feedback draft input object',
+        });
+        return { ok: false, errors };
+    }
+    // Required: type
+    if (!Object.hasOwn(value, 'type')) {
+        errors.push({
+            field: 'type',
+            reason: 'type is required (ERR-009)',
+            nextAction: 'add a type field with a valid FeedbackType value',
+        });
+    }
+    else if (!isFeedbackType(value.type)) {
+        errors.push({
+            field: 'type',
+            reason: 'type must be one of: bug, confusing, privacy_concern, feature_request, other (ERR-010)',
+            nextAction: 'provide a valid FeedbackType string',
+        });
+    }
+    // Required: title
+    if (!Object.hasOwn(value, 'title')) {
+        errors.push({
+            field: 'title',
+            reason: 'title is required (ERR-009)',
+            nextAction: 'add a title field with a string value',
+        });
+    }
+    else if (!isString(value.title)) {
+        errors.push({
+            field: 'title',
+            reason: 'title must be a string (ERR-010)',
+            nextAction: 'provide a string value for title',
+        });
+    }
+    // Required: description
+    if (!Object.hasOwn(value, 'description')) {
+        errors.push({
+            field: 'description',
+            reason: 'description is required (ERR-009)',
+            nextAction: 'add a description field with a string value',
+        });
+    }
+    else if (!isString(value.description)) {
+        errors.push({
+            field: 'description',
+            reason: 'description must be a string (ERR-010)',
+            nextAction: 'provide a string value for description',
+        });
+    }
+    // Optional: stepsToReproduce, expectedBehavior, actualBehavior
+    validateOptionalString(value.stepsToReproduce, 'stepsToReproduce', errors);
+    validateOptionalString(value.expectedBehavior, 'expectedBehavior', errors);
+    validateOptionalString(value.actualBehavior, 'actualBehavior', errors);
+    // Optional: userSeverity
+    if (value.userSeverity !== undefined && !isUserSeverity(value.userSeverity)) {
+        errors.push({
+            field: 'userSeverity',
+            reason: 'userSeverity must be one of: low, medium, high (ERR-010)',
+            nextAction: 'provide a valid UserSeverity value or omit it',
+        });
+    }
+    // Optional: context (object, validated recursively)
+    let context = undefined;
+    if (value.context !== undefined) {
+        const ctxErrors = validateFeedbackContext(value.context);
+        for (const e of ctxErrors)
+            errors.push(e);
+        if (isRecord(value.context) && isFeedbackSource(value.context.source)) {
+            const c = value.context;
+            const built = { source: c.source };
+            if (isString(c.page))
+                built.page = c.page;
+            if (isString(c.painId))
+                built.painId = c.painId;
+            if (isString(c.principleId))
+                built.principleId = c.principleId;
+            if (isString(c.approvalId))
+                built.approvalId = c.approvalId;
+            if (isString(c.activationId))
+                built.activationId = c.activationId;
+            if (isString(c.updateAttemptId))
+                built.updateAttemptId = c.updateAttemptId;
+            context = built;
+        }
+    }
+    // Optional: agentDraft
+    let agentDraft = undefined;
+    if (value.agentDraft !== undefined) {
+        const adErrors = validateAgentDraft(value.agentDraft);
+        for (const e of adErrors)
+            errors.push(e);
+        if (isRecord(value.agentDraft) && isString(value.agentDraft.summary)) {
+            const a = value.agentDraft;
+            const built = { summary: a.summary };
+            if (isString(a.observedFailure))
+                built.observedFailure = a.observedFailure;
+            if (isString(a.commandSummary))
+                built.commandSummary = a.commandSummary;
+            agentDraft = built;
+        }
+    }
+    if (errors.length > 0)
+        return { ok: false, errors };
+    const type = value.type;
+    const title = value.title;
+    const description = value.description;
+    const userText = { description };
+    if (isString(value.stepsToReproduce))
+        userText.stepsToReproduce = value.stepsToReproduce;
+    if (isString(value.expectedBehavior))
+        userText.expectedBehavior = value.expectedBehavior;
+    if (isString(value.actualBehavior))
+        userText.actualBehavior = value.actualBehavior;
+    if (isUserSeverity(value.userSeverity))
+        userText.userSeverity = value.userSeverity;
+    const normalized = { type, title, userText };
+    if (context)
+        normalized.context = context;
+    if (agentDraft)
+        normalized.agentDraft = agentDraft;
+    return { ok: true, value: normalized };
+}
+//# sourceMappingURL=feedback-types.js.map

package/dist/runtime-v2/feedback/feedback-types.js.map

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