create-principles-disciple 1.109.0 → 1.111.0

package/console/dist/server/feedback/submit-service.js

@@ -0,0 +1,177 @@
+// submit-service.ts
+// Orchestrates a feedback submission: load the saved (already-redacted) draft
+// by id, compute its fingerprint, hand it to the chosen adapter, then write
+// the receipt back when the adapter succeeds (spec §8.2).
+//
+// Trust boundaries:
+// - The request body never carries report content — only { channel } (route-level).
+//   Everything sent onwards comes from the re-loaded disk draft.
+// - Idempotency: an already-submitted draft returns alreadySubmitted:true and
+//   is never resubmitted.
+// - Failure never downgrades the draft's status: any adapter error leaves it
+//   'draft' with a structured reason + nextAction (rc-9).
+// - Write-back failure still returns success + writeBackFailed:true rather than
+//   dropping the receipt (spec §12 — "宁重复提示不丢回执").
+import { computeFeedbackFingerprint, } from '@principles/core/runtime-v2/feedback';
+import { submitToIngest } from './ingest-adapter.js';
+import { submitToGithub } from './github-adapter.js';
+/**
+ * Submit a saved draft by id through the given channel. `maintainerEmail`
+ * (route-level) is accepted separately for parity/future use.
+ */
+export async function submitReport(opts) {
+    const { model, reportId, channel, config, deps } = opts;
+    // 1. Load the saved draft (already redacted at creation time).
+    const loaded = await model.get(reportId);
+    const { ok, report, errorCode, error } = loaded;
+    if (!ok || !report) {
+        if (errorCode === 'NOT_FOUND') {
+            return {
+                ok: false,
+                statusCode: 404,
+                error: 'feedback_report_not_found',
+                message: `No saved feedback draft with id ${reportId}`,
+                nextAction: '从草稿列表选择一个已保存的反馈再提交',
+            };
+        }
+        return {
+            ok: false,
+            statusCode: 400,
+            error: 'feedback_report_load_failed',
+            message: `Failed to load draft: ${error ?? 'unknown'}`,
+            nextAction: '检查草稿文件是否可读后重试',
+        };
+    }
+    // 2. Idempotency — never resubmit an already-submitted draft.
+    if (report.status === 'submitted') {
+        return {
+            ok: true,
+            alreadySubmitted: true,
+            status: 'submitted',
+            submittedVia: report.submittedVia,
+            trackingId: report.trackingId,
+            externalUrl: report.externalUrl,
+        };
+    }
+    // 3. Channel configuration gate (single-channel disable = remove its config key).
+    if (channel === 'ingest' && config.ingestUrl.length === 0) {
+        return {
+            ok: false,
+            statusCode: 400,
+            error: 'ingest_channel_not_configured',
+            message: 'ingest 通道未配置(feedback.ingest_url 为空)',
+            nextAction: '在 .pd/config.yaml 配置 feedback.ingest_url,或选择其他通道',
+        };
+    }
+    if (channel === 'github' && config.githubRepo.length === 0) {
+        return {
+            ok: false,
+            statusCode: 400,
+            error: 'github_channel_not_configured',
+            message: 'gh 通道未配置(feedback.github_repo 为空)',
+            nextAction: '在 .pd/config.yaml 配置 feedback.github_repo,或选择其他通道',
+        };
+    }
+    // 4. Deterministic fingerprint for relay-side dedup/clustering.
+    const fingerprint = computeFeedbackFingerprint({
+        type: report.type,
+        title: report.title,
+        area: report.area,
+    });
+    const { area } = report;
+    const submittedAt = new Date().toISOString();
+    if (channel === 'ingest') {
+        const outcome = await submitToIngest({
+            url: config.ingestUrl,
+            token: config.ingestToken,
+            report,
+            fingerprint,
+            area,
+            fetchFn: deps?.fetchFn,
+        });
+        if (!outcome.ok) {
+            // 0 = network/timeout (downstream). Failed → keep draft untouched.
+            return {
+                ok: false,
+                statusCode: outcome.status === 0 ? 502 : outcome.status,
+                error: 'ingest_submit_failed',
+                message: outcome.reason,
+                nextAction: outcome.nextAction,
+            };
+        }
+        // 5a. Write receipt back; a write-back failure must not drop the success.
+        const patch = {
+            status: 'submitted',
+            submittedAt,
+            submittedVia: 'ingest',
+        };
+        if (outcome.trackingId)
+            patch.trackingId = outcome.trackingId;
+        if (outcome.issueUrl)
+            patch.externalUrl = outcome.issueUrl;
+        const wb = await model.update(reportId, patch);
+        if (!wb.ok || !wb.report) {
+            return {
+                ok: true,
+                alreadySubmitted: false,
+                status: 'submitted',
+                submittedVia: 'ingest',
+                trackingId: outcome.trackingId,
+                externalUrl: outcome.issueUrl,
+                writeBackFailed: true,
+                nextAction: '提交已完成但状态写回失败,请手动记录回执编号(可在此页面查看)',
+            };
+        }
+        return {
+            ok: true,
+            alreadySubmitted: false,
+            status: 'submitted',
+            submittedVia: 'ingest',
+            trackingId: outcome.trackingId,
+            externalUrl: outcome.issueUrl,
+        };
+    }
+    // github
+    const outcome = await submitToGithub({
+        repo: config.githubRepo,
+        proxy: config.githubProxy,
+        report,
+        execFile: deps?.execFile,
+        fs: deps?.fs,
+        os: deps?.os,
+        path: deps?.path,
+    });
+    if (!outcome.ok) {
+        return {
+            ok: false,
+            statusCode: 502,
+            error: 'github_submit_failed',
+            message: outcome.reason,
+            nextAction: outcome.nextAction,
+        };
+    }
+    const wb = await model.update(reportId, {
+        status: 'submitted',
+        submittedAt,
+        submittedVia: 'github',
+        externalUrl: outcome.issueUrl,
+    });
+    if (!wb.ok || !wb.report) {
+        return {
+            ok: true,
+            alreadySubmitted: false,
+            status: 'submitted',
+            submittedVia: 'github',
+            externalUrl: outcome.issueUrl,
+            writeBackFailed: true,
+            nextAction: '提交已完成但状态写回失败,请手动记录 issue 链接',
+        };
+    }
+    return {
+        ok: true,
+        alreadySubmitted: false,
+        status: 'submitted',
+        submittedVia: 'github',
+        externalUrl: outcome.issueUrl,
+    };
+}

package/console/dist/server/index.js

@@ -2,11 +2,11 @@ import * as http from 'http';
 import * as fs from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
-import { loadPdConfig, computeFlagsFromLoadResult, getFeedbackMaintainerEmail } from './config/pd-config-store.js';
+import { loadPdConfig, computeFlagsFromLoadResult, getFeedbackMaintainerEmail, getFeedbackChannelConfig, } from './config/pd-config-store.js';
 import { AuthConfig } from './config/AuthConfig.js';
 import { WorkspaceConfigStore } from './config/WorkspaceConfigStore.js';
 import { WorkspaceService } from './models/WorkspaceService.js';
-import { handleFeedbackReportsRoute, disposeFeedbackReportModels } from './routes/feedback-reports.js';
+import { handleFeedbackReportsRoute, handleFeedbackChannelsRoute, disposeFeedbackReportModels, } from './routes/feedback-reports.js';
 import { handleFailedTasksRoute, disposeFailedTasksModels } from './routes/failed-tasks.js';
 import { handleApprovalsRoute, disposeApprovalsModels } from './routes/approvals.js';
 import { handleHealthRoute, disposeHealthModels } from './routes/health.js';
@@ -216,10 +216,14 @@ async function initServices(workspaceDir, authConfig) {
     if (!configResult.ok) {
         console.warn('[pd-console] PD config loading failed (using defaults for feedback channel):', configResult.errors.map(e => e.reason).join('; '));
     }
-    // Read feedback.maintainer_email from .pd/config.yaml (defaults to
-    // csuzngjh@hotmail.com when absent). Used to build mailto: URLs in feedback
-    // reports so the owner can open a pre-filled email directly.
+    // Read feedback.maintainer_email from .pd/config.yaml. Falls back to a
+    // placeholder (maintainer@example.com) when absent; UI/email channel honours
+    // that default at the channel-level (not here). Used to build mailto: URLs in
+    // feedback reports so the owner can open a pre-filled email directly.
     const maintainerEmail = getFeedbackMaintainerEmail(workspaceDir);
+    // Read the feedback submit-channel parameters (ingest_url / ingest_token /
+    // github_repo / github_proxy). Presence of a key enables its channel.
+    const feedbackChannelConfig = getFeedbackChannelConfig(workspaceDir);
     return {
         workspaceDir,
         authConfig,
@@ -227,6 +231,7 @@ async function initServices(workspaceDir, authConfig) {
         workspaceService,
         feedbackFlags,
         maintainerEmail,
+        feedbackChannelConfig,
     };
 }
 async function closeServices() {
@@ -277,10 +282,21 @@ function handleRequest(services) {
                 return;
             }
             // ── API routes ──────────────────────────────────────────────────
-            // GET/POST /api/feedback/reports, /api/feedback/reports/:id
+            // GET /api/feedback/submit/channels — submit-ladder probe
+            if (urlPath === '/api/feedback/submit/channels') {
+                asyncHandler(() => handleFeedbackChannelsRoute(req, res, {
+                    workspaceDir: services.workspaceDir,
+                    channelConfig: services.feedbackChannelConfig,
+                    featureFlags: services.feedbackFlags,
+                    maintainerEmail: services.maintainerEmail,
+                }))(req, res);
+                return;
+            }
+            // GET/POST /api/feedback/reports, /api/feedback/reports/:id,
+            // POST /api/feedback/reports/:id/submit
             if (urlPath === '/api/feedback/reports' || urlPath.startsWith('/api/feedback/reports/')) {
                 const subPath = urlPath.slice('/api/feedback/reports'.length);
-                asyncHandler(() => handleFeedbackReportsRoute(req, res, { workspaceDir: services.workspaceDir, subPath, featureFlags: services.feedbackFlags, maintainerEmail: services.maintainerEmail }))(req, res);
+                asyncHandler(() => handleFeedbackReportsRoute(req, res, { workspaceDir: services.workspaceDir, subPath, featureFlags: services.feedbackFlags, maintainerEmail: services.maintainerEmail, channelConfig: services.feedbackChannelConfig }))(req, res);
                 return;
             }
             // Task 9: GET /api/v1/failed-tasks, /api/v1/failed-tasks/:id

package/console/dist/server/models/FeedbackReportConsoleModel.d.ts

@@ -4,6 +4,8 @@ export type FeedbackReportDraftSummary = {
     createdAt: string;
     type: string;
     title: string;
+    /** 分发状态(缺省 draft);用于草稿列表区分 待发/已发(切片3) */
+    status?: string;
 };
 export type FeedbackReportListResult = {
     ok: boolean;
@@ -45,5 +47,11 @@ export declare class FeedbackReportConsoleModel {
      * Delete a draft by id. No-op (still ok:true) if the file does not exist.
      */
     delete(id: string): Promise<FeedbackReportDeleteResult>;
+    /**
+     * Update a persisted draft by applying a partial patch, then atomic-write.
+     * Mirrors `create` (tmp + rename). Fails loud (not_found / read_error /
+     * invalid shape) without mutating on error.
+     */
+    update(id: string, patch: Partial<FeedbackReport>): Promise<FeedbackReportGetResult>;
     dispose(): void;
 }

package/console/dist/server/models/FeedbackReportConsoleModel.js

@@ -138,6 +138,7 @@ export class FeedbackReportConsoleModel {
                             createdAt: obj.createdAt,
                             type: obj.type,
                             title: obj.title,
+                            status: typeof obj.status === 'string' ? obj.status : undefined,
                         });
                     }
                 }
@@ -233,6 +234,50 @@ export class FeedbackReportConsoleModel {
             };
         }
     }
+    /**
+     * Update a persisted draft by applying a partial patch, then atomic-write.
+     * Mirrors `create` (tmp + rename). Fails loud (not_found / read_error /
+     * invalid shape) without mutating on error.
+     */
+    async update(id, patch) {
+        if (!reportIdValidator(id)) {
+            return {
+                ok: false,
+                error: `Invalid feedback report id: ${JSON.stringify(id)}`,
+                errorCode: 'INVALID_ID',
+                nextAction: 'pass a safe id matching /^[A-Za-z0-9._-]+$/ with length 1-256',
+            };
+        }
+        if (patch === null || typeof patch !== 'object' || Array.isArray(patch)) {
+            return {
+                ok: false,
+                error: 'patch must be a plain object with optional FeedbackReport fields',
+                nextAction: 'pass a partial FeedbackReport object to update',
+            };
+        }
+        const loaded = await this.get(id);
+        if (!loaded.ok || !loaded.report)
+            return loaded;
+        const merged = { ...loaded.report, ...patch, id };
+        const dir = this.ensureDraftsDir();
+        if (!dir.ok)
+            return dir;
+        const filePath = path.join(this.draftsDir, `${id}.json`);
+        try {
+            const tmpPath = `${filePath}.${randomUUID()}.tmp`;
+            const body = JSON.stringify(merged, null, 2);
+            await fs.promises.writeFile(tmpPath, body, { encoding: 'utf8', mode: 0o600 });
+            await fs.promises.rename(tmpPath, filePath);
+            return { ok: true, report: merged };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: `Failed to write feedback report update at ${filePath}: ${err instanceof Error ? err.message : String(err)}`,
+                nextAction: 'verify the workspace directory is writable and that disk space is available',
+            };
+        }
+    }
     dispose() {
         // Nothing to dispose; this model holds no connections.
         // (This override satisfies the class-methods-use-this ESLint rule for

package/console/dist/server/routes/feedback-reports.d.ts

@@ -1,4 +1,7 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { FeedbackChannelConfig } from '../config/pd-config-store.js';
+import { probeChannels } from '../feedback/channels.js';
+import { type SubmitDeps } from '../feedback/submit-service.js';
 /**
  * Handle requests to `/api/feedback/reports*` for the given workspace.
  * Routes:
@@ -6,6 +9,7 @@ import type { IncomingMessage, ServerResponse } from 'node:http';
  *   GET    /api/feedback/reports        — list draft summaries
  *   GET    /api/feedback/reports/:id    — fetch a single draft
  *   DELETE /api/feedback/reports/:id    — delete a draft
+ *   POST   /api/feedback/reports/:id/submit — submit a saved draft via a channel
  */
 export type FeedbackReportsContext = {
     workspaceDir: string;
@@ -14,6 +18,26 @@ export type FeedbackReportsContext = {
         enabled: boolean;
     }>;
     maintainerEmail?: string;
+    channelConfig?: FeedbackChannelConfig;
+    submitDeps?: SubmitDeps;
 };
 export declare function handleFeedbackReportsRoute(req: IncomingMessage, res: ServerResponse, ctx: FeedbackReportsContext): Promise<void>;
+/**
+ * Channels context for the submit-ladder probe endpoint.
+ */
+export type FeedbackChannelsContext = {
+    workspaceDir: string;
+    channelConfig?: FeedbackChannelConfig;
+    featureFlags?: Record<string, {
+        enabled: boolean;
+    }>;
+    maintainerEmail?: string;
+    channelDeps?: Parameters<typeof probeChannels>[1];
+};
+/**
+ * GET /api/feedback/submit/channels — build the channel ladder availability
+ * (spec §8.1). When the feedback_channel flag is off, the whole submit area is
+ * hidden from the UI; the endpoint still probes but the client drops it.
+ */
+export declare function handleFeedbackChannelsRoute(req: IncomingMessage, res: ServerResponse, ctx: FeedbackChannelsContext): Promise<void>;
 export declare function disposeFeedbackReportModels(): void;

package/console/dist/server/routes/feedback-reports.js

@@ -8,6 +8,8 @@
 import { createFeedbackReport, PendingAgentDraftStore, } from '@principles/core/runtime-v2/feedback';
 import { SqliteConnection } from '@principles/core/runtime-v2';
 import { FeedbackReportConsoleModel, } from '../models/FeedbackReportConsoleModel.js';
+import { probeChannels } from '../feedback/channels.js';
+import { submitReport } from '../feedback/submit-service.js';
 import { sendSuccess, sendError, sendNotFound, sendMethodNotAllowed, sendBadRequest, } from '../utils/response.js';
 const models = new Map();
 function getModel(workspaceDir) {
@@ -67,6 +69,10 @@ async function readJsonBody(req) {
 function errorMessage(err) {
     return err instanceof Error ? err.message : String(err);
 }
+// Matches /:id/submit where :id is a safe report id.
+const SUBMIT_SUBPATH = /^\/[A-Za-z0-9._-]+\/submit$/;
+// Matches /:id/mark-sent (manual "marked as sent" for mailto/export channels).
+const MARK_SENT_SUBPATH = /^\/[A-Za-z0-9._-]+\/mark-sent$/;
 export async function handleFeedbackReportsRoute(req, res, ctx) {
     const { workspaceDir, subPath } = ctx;
     const model = getModel(workspaceDir);
@@ -131,6 +137,127 @@ export async function handleFeedbackReportsRoute(req, res, ctx) {
         sendMethodNotAllowed(res);
         return;
     }
+    // Submit: POST /api/feedback/reports/:id/submit (feature-flag gated).
+    if (SUBMIT_SUBPATH.test(subPath)) {
+        if (method !== 'POST') {
+            sendMethodNotAllowed(res);
+            return;
+        }
+        // Feature flag gate — feedback_channel off ⇒ submit endpoint 403 (spec §12).
+        if (ctx.featureFlags
+            && Object.hasOwn(ctx.featureFlags, 'feedback_channel')) {
+            const feedbackChannel = ctx.featureFlags.feedback_channel;
+            if (feedbackChannel && !feedbackChannel.enabled) {
+                sendError(res, 403, 'feedback_channel_disabled', 'feedback_channel feature flag is disabled. Enable feedback_channel in .pd/config.yaml to submit feedback.', { nextAction: '在 .pd/config.yaml 将 features.feedback_channel.enabled 改为 true' });
+                return;
+            }
+        }
+        // The report id is everything before the trailing "/submit".
+        const reportId = subPath.slice(1, subPath.length - '/submit'.length);
+        const bodyResult = await readJsonBody(req);
+        if (!bodyResult.ok) {
+            sendBadRequest(res, bodyResult.error);
+            return;
+        }
+        if (bodyResult.value === null || typeof bodyResult.value !== 'object' || Array.isArray(bodyResult.value)) {
+            sendBadRequest(res, 'request body must be a JSON object with { channel }');
+            return;
+        }
+        const obj = bodyResult.value;
+        const channelRaw = Object.hasOwn(obj, 'channel') ? obj.channel : undefined;
+        if (channelRaw !== 'ingest' && channelRaw !== 'github') {
+            sendBadRequest(res, 'channel must be one of: "ingest", "github"');
+            return;
+        }
+        const channel = channelRaw;
+        try {
+            const result = await submitReport({
+                model,
+                reportId,
+                channel,
+                config: ctx.channelConfig ?? { ingestUrl: '', ingestToken: '', githubRepo: '', githubProxy: '' },
+                deps: ctx.submitDeps,
+            });
+            if (!result.ok) {
+                sendError(res, result.statusCode, result.error, result.message, { nextAction: result.nextAction });
+                return;
+            }
+            sendSuccess(res, result);
+        }
+        catch (err) {
+            // rc-9: never silence — structured error + nextAction.
+            sendError(res, 500, 'feedback_reports_submit_error', errorMessage(err), {
+                nextAction: '稍后重试;或改用导出文件通道发送给维护者',
+            });
+        }
+        return;
+    }
+    // Manual "mark as sent" for mailto/export channels (spec §11.4): user
+    // declares the draft delivered; the console cannot confirm server-side, so
+    // this is an honest client-declared status write-back — never a fake ack.
+    if (MARK_SENT_SUBPATH.test(subPath)) {
+        if (method !== 'POST') {
+            sendMethodNotAllowed(res);
+            return;
+        }
+        if (ctx.featureFlags
+            && Object.hasOwn(ctx.featureFlags, 'feedback_channel')) {
+            const feedbackChannel = ctx.featureFlags.feedback_channel;
+            if (feedbackChannel && !feedbackChannel.enabled) {
+                sendError(res, 403, 'feedback_channel_disabled', 'feedback_channel feature flag is disabled. Enable feedback_channel in .pd/config.yaml to mark feedback as sent.', { nextAction: '在 .pd/config.yaml 将 features.feedback_channel.enabled 改为 true' });
+                return;
+            }
+        }
+        const reportId = subPath.slice(1, subPath.length - '/mark-sent'.length);
+        const bodyResult = await readJsonBody(req);
+        if (!bodyResult.ok) {
+            sendBadRequest(res, bodyResult.error);
+            return;
+        }
+        const viaRaw = bodyResult.value !== null &&
+            typeof bodyResult.value === 'object' &&
+            !Array.isArray(bodyResult.value)
+            ? bodyResult.value.via
+            : undefined;
+        if (viaRaw !== 'email' && viaRaw !== 'file') {
+            sendBadRequest(res, 'via must be one of: "email", "file"');
+            return;
+        }
+        try {
+            const loaded = await model.get(reportId);
+            if (!loaded.ok || !loaded.report) {
+                sendError(res, loaded.errorCode === 'NOT_FOUND' ? 404 : 400, 'mark_sent_report_not_found', loaded.error ?? 'draft not found', {
+                    nextAction: '从草稿列表选择一个已保存的反馈再标记',
+                });
+                return;
+            }
+            // Honesty: do not re-stamp an already-submitted draft (alreadySubmitted).
+            if (loaded.report.status === 'submitted') {
+                sendSuccess(res, {
+                    ok: true,
+                    alreadySubmitted: true,
+                    status: 'submitted',
+                    submittedVia: loaded.report.submittedVia,
+                    trackingId: loaded.report.trackingId,
+                    externalUrl: loaded.report.externalUrl,
+                });
+                return;
+            }
+            const submittedAt = new Date().toISOString();
+            const wb = await model.update(reportId, { status: 'submitted', submittedAt, submittedVia: viaRaw });
+            if (!wb.ok || !wb.report) {
+                sendError(res, 500, 'mark_sent_write_back_failed', wb.error ?? 'write-back failed', {
+                    nextAction: '标记失败,请稍后重试',
+                });
+                return;
+            }
+            sendSuccess(res, { ok: true, alreadySubmitted: false, status: 'submitted', submittedVia: viaRaw, submittedAt });
+        }
+        catch (err) {
+            sendError(res, 500, 'mark_sent_error', errorMessage(err), { nextAction: '标记失败,请稍后重试' });
+        }
+        return;
+    }
     // Single draft: /:id
     const id = subPath.replace(/^\//, '');
     if (id.length === 0) {
@@ -176,6 +303,30 @@ export async function handleFeedbackReportsRoute(req, res, ctx) {
     }
     sendMethodNotAllowed(res);
 }
+/**
+ * GET /api/feedback/submit/channels — build the channel ladder availability
+ * (spec §8.1). When the feedback_channel flag is off, the whole submit area is
+ * hidden from the UI; the endpoint still probes but the client drops it.
+ */
+export async function handleFeedbackChannelsRoute(req, res, ctx) {
+    const method = req.method ?? 'GET';
+    if (method !== 'GET') {
+        sendMethodNotAllowed(res);
+        return;
+    }
+    try {
+        const config = ctx.channelConfig ?? { ingestUrl: '', ingestToken: '', githubRepo: '', githubProxy: '' };
+        const result = await probeChannels(config, ctx.channelDeps ?? {}, ctx.maintainerEmail ?? '');
+        // Never leak the ingest token into a client-facing payload (probeChannels already omits it).
+        sendSuccess(res, { channels: result.channels });
+    }
+    catch (err) {
+        // rc-9: structured failure with nextAction; the client hides submit area.
+        sendError(res, 500, 'feedback_channels_probe_error', errorMessage(err), {
+            nextAction: '稍后重试;或直接使用导出文件通道',
+        });
+    }
+}
 export function disposeFeedbackReportModels() {
     for (const model of models.values()) {
         model.dispose();

package/console/dist/ui/api.d.ts

@@ -1,6 +1,6 @@
 import type { ApiResponse } from "../types.js";
 import { listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm } from "./utils/signal-keywords-api.js";
-import type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, RuntimeProfileMutationData, ReadinessCheckData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, ActivationsData, DisableActivationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, ApprovalsGroupedData, EvidenceChainData, TrajectoryData, IntentSummaryData, IntentDecisionRecordData, IntentDecisionResultData, IntentDecisionSummaryData, FollowUpResponseData, IntentInitResultData, IntentSaveResultData, IntentRawContentData, IntentVersionData } from "./utils/validators.js";
+import type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, FeedbackChannelsData, FeedbackSubmitResultData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, RuntimeProfileMutationData, ReadinessCheckData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, ActivationsData, DisableActivationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, ApprovalsGroupedData, EvidenceChainData, TrajectoryData, IntentSummaryData, IntentDecisionRecordData, IntentDecisionResultData, IntentDecisionSummaryData, FollowUpResponseData, IntentInitResultData, IntentSaveResultData, IntentRawContentData, IntentVersionData } from "./utils/validators.js";
 declare function getToken(): string | null;
 declare function setToken(token: string): void;
 declare function clearToken(): void;
@@ -37,6 +37,14 @@ declare function listFeedbackReports(): Promise<ApiResponse<{
 }>>;
 declare function getFeedbackReport(id: string): Promise<ApiResponse<FeedbackDraftEnvelopeData>>;
 declare function deleteFeedbackReport(id: string): Promise<ApiResponse<DeleteEnvelopeData>>;
+declare function fetchFeedbackChannels(): Promise<ApiResponse<FeedbackChannelsData>>;
+declare function submitFeedbackReport(id: string, channel: 'ingest' | 'github'): Promise<ApiResponse<FeedbackSubmitResultData>>;
+/**
+ * Manually mark a draft as sent (mailto/export channels, spec §11.4). The
+ * console cannot server-confirm delivery for these channels, so this is an
+ * honest user-declared status write-back — never a fake acknowledgement.
+ */
+declare function markFeedbackReportSent(id: string, via: 'email' | 'file'): Promise<ApiResponse<FeedbackSubmitResultData>>;
 declare function fetchConfigSummary(): Promise<ApiResponse<ConfigSummaryData>>;
 declare function fetchConfigCatalog(): Promise<ApiResponse<ConfigCatalogData>>;
 declare function updateAgentBinding(agentName: string, runtimeProfile: string, enabled: boolean): Promise<ApiResponse<AgentBindingUpdateData>>;
@@ -148,8 +156,8 @@ export interface FollowUpPayload {
     candidateId?: string;
 }
 declare function dispatchFollowUp(decisionId: string, payload: FollowUpPayload): Promise<ApiResponse<FollowUpResponseData>>;
-export { request, listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleTrajectory, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, createRuntimeProfile, updateRuntimeProfile, deleteRuntimeProfile, fetchAgentReadiness, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, applyFullUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };
-export type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, RuntimeProfileMutationData, ReadinessCheckData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, ActivationsData, DisableActivationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, ApprovalsGroupedData, EvidenceChainData, EvidenceChainRecordData, EvidenceChainStateData, TrajectoryData, TrajectoryStageData, IntentSummaryData, IntentSectionsData, IntentDocWarningData, IntentDecisionRecordData, IntentDecisionResultData, IntentDecisionSummaryData, FollowUpResponseData, LinkCandidateFollowUpData, GuideRulehostFollowUpData, GeneratePatchProposalFollowUpData, IntentVersionEntry, IntentVersionData, } from "./utils/validators.js";
+export { request, listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleTrajectory, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchFeedbackChannels, submitFeedbackReport, markFeedbackReportSent, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, createRuntimeProfile, updateRuntimeProfile, deleteRuntimeProfile, fetchAgentReadiness, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, applyFullUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };
+export type { FeedbackReportData, FeedbackDraftSummaryData, FeedbackDraftEnvelopeData, FeedbackChannelsData, FeedbackSubmitResultData, DeleteEnvelopeData, WorkspaceEntryData, RemovedEnvelopeData, SyncResultData, ConfigSummaryData, ConfigCatalogData, AgentBindingUpdateData, DefaultRuntimeUpdateData, RuntimeProfileMutationData, ReadinessCheckData, FeatureFlagUpdateData, OutputLanguageData, GovernanceQueueData, ActivationsData, DisableActivationData, LifecycleMetricsData, UpdateStatusData, UpdateHistoryData, ApplyUpdateResultData, RollbackResultData, ApprovalRecordData, PrinciplesListData, ApprovalsGroupedData, EvidenceChainData, EvidenceChainRecordData, EvidenceChainStateData, TrajectoryData, TrajectoryStageData, IntentSummaryData, IntentSectionsData, IntentDocWarningData, IntentDecisionRecordData, IntentDecisionResultData, IntentDecisionSummaryData, FollowUpResponseData, LinkCandidateFollowUpData, GuideRulehostFollowUpData, GeneratePatchProposalFollowUpData, IntentVersionEntry, IntentVersionData, } from "./utils/validators.js";
 export type { SignalKeyword, PendingSignalTerm } from "./utils/signal-keywords-types.js";
 export type { ActivationRecordData as ActivationRecord } from "./utils/validators.js";
 export type { ApprovalRecordData as ApprovalRecord } from "./utils/validators.js";

package/console/dist/ui/api.js

@@ -1,5 +1,5 @@
 import { listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, } from "./utils/signal-keywords-api.js";
-import { validateErrorResponse, validateHeaders, validateFeedbackReport, validateFeedbackDraftsList, validateFeedbackDraftEnvelope, validateDeleteEnvelope, validateWorkspaceEntry, validateWorkspaceList, validateRemovedEnvelope, validateSyncResult, validateConfigSummary, validateConfigCatalog, validateAgentBindingUpdate, validateDefaultRuntimeUpdate, validateRuntimeProfileMutation, validateReadinessCheck, validateFeatureFlagUpdate, validateOutputLanguage, validateGovernanceQueue, validateActivations, validateDisableActivation, validateLifecycleMetrics, validateUpdateStatus, validateUpdateHistory, validateApplyUpdateResult, validateRollbackResult, validateApprovalRecordDirect, validatePrinciplesList, validateApprovalsGrouped, validateEvidenceChain, validateTrajectoryData, validateIntentSummary, validateIntentDecisionList, validateIntentDecisionResult, validateIntentDecisionSummary, validateFollowUpResponse, validateIntentInitResult, validateIntentSaveResult, validateIntentRawContent, validateIntentVersions, } from "./utils/validators.js";
+import { validateErrorResponse, validateHeaders, validateFeedbackReport, validateFeedbackDraftsList, validateFeedbackDraftEnvelope, validateFeedbackChannels, validateFeedbackSubmitResult, validateDeleteEnvelope, validateWorkspaceEntry, validateWorkspaceList, validateRemovedEnvelope, validateSyncResult, validateConfigSummary, validateConfigCatalog, validateAgentBindingUpdate, validateDefaultRuntimeUpdate, validateRuntimeProfileMutation, validateReadinessCheck, validateFeatureFlagUpdate, validateOutputLanguage, validateGovernanceQueue, validateActivations, validateDisableActivation, validateLifecycleMetrics, validateUpdateStatus, validateUpdateHistory, validateApplyUpdateResult, validateRollbackResult, validateApprovalRecordDirect, validatePrinciplesList, validateApprovalsGrouped, validateEvidenceChain, validateTrajectoryData, validateIntentSummary, validateIntentDecisionList, validateIntentDecisionResult, validateIntentDecisionSummary, validateFollowUpResponse, validateIntentInitResult, validateIntentSaveResult, validateIntentRawContent, validateIntentVersions, } from "./utils/validators.js";
 // ── Auth ──────────────────────────────────────────────────────────────────────
 function getToken() {
     return sessionStorage.getItem("pd_token");
@@ -182,6 +182,27 @@ async function deleteFeedbackReport(id) {
         method: 'DELETE',
     }, validateDeleteEnvelope);
 }
+// ── Feedback submit ladder (Slice 3, spec §8) ─────────────────────────────────
+async function fetchFeedbackChannels() {
+    return request('/api/feedback/submit/channels', undefined, validateFeedbackChannels);
+}
+async function submitFeedbackReport(id, channel) {
+    return request('/api/feedback/reports/' + encodeURIComponent(id) + '/submit', {
+        method: 'POST',
+        body: JSON.stringify({ channel }),
+    }, validateFeedbackSubmitResult);
+}
+/**
+ * Manually mark a draft as sent (mailto/export channels, spec §11.4). The
+ * console cannot server-confirm delivery for these channels, so this is an
+ * honest user-declared status write-back — never a fake acknowledgement.
+ */
+async function markFeedbackReportSent(id, via) {
+    return request('/api/feedback/reports/' + encodeURIComponent(id) + '/mark-sent', {
+        method: 'POST',
+        body: JSON.stringify({ via }),
+    }, validateFeedbackSubmitResult);
+}
 // ── Config / Control Center API (PRI-303, PRI-309) ───────────────────────────
 async function fetchConfigSummary() {
     return request('/api/v1/config/summary', undefined, validateConfigSummary);
@@ -381,4 +402,6 @@ export { request,
 // signal-keywords (UI stubs, see signal-keywords-api.ts)
 listActiveSignalKeywords, listPendingSignalTerms, fetchKeywordStore, fetchPendingTerms, updateKeywordStore, admitPendingTerm, rejectPendingTerm, 
 // auth
-getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleTrajectory, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, createRuntimeProfile, updateRuntimeProfile, deleteRuntimeProfile, fetchAgentReadiness, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, applyFullUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };
+getToken, setToken, clearToken, checkAuth, approveApproval, rejectApproval, editApproval, fetchPrinciples, fetchPrincipleDetail, fetchPrincipleTrajectory, archivePrinciple, unarchivePrinciple, createFeedbackReport, listFeedbackReports, getFeedbackReport, deleteFeedbackReport, 
+// Feedback submit ladder (Slice 3, spec §8)
+fetchFeedbackChannels, submitFeedbackReport, markFeedbackReportSent, fetchConfigSummary, fetchConfigCatalog, updateAgentBinding, updateDefaultRuntime, createRuntimeProfile, updateRuntimeProfile, deleteRuntimeProfile, fetchAgentReadiness, patchFeatureFlag, fetchOutputLanguage, updateOutputLanguage, fetchWorkspaces, addWorkspace, removeWorkspace, syncWorkspace, fetchGovernanceQueue, fetchApprovalsGrouped, fetchAllActivations, disableActivation, fetchLifecycleMetrics, fetchUpdateStatus, fetchUpdateHistory, applyUpdate, applyFullUpdate, rollbackUpdate, fetchEvidenceChain, fetchIntentSummary, fetchIntentContent, createIntentTemplate, saveIntentContent, fetchIntentVersions, recordIntentDecision, listIntentDecisionsByPainId, listIntentDecisionsByTaskId, fetchIntentDecisionSummary, dispatchFollowUp, };