@deftai/directive-core 0.80.0 → 0.81.0

package/dist/product-signal/local-signal-summary.js

@@ -0,0 +1,173 @@
+import { existsSync, readFileSync } from "node:fs";
+import { evaluateHealth } from "../eval/health.js";
+import { healthMetricsHistoryPath, helpedMetricsHistoryPath, } from "../metrics/resolve-metrics-home.js";
+import { resolveValueFeedback } from "../policy/value-feedback.js";
+import { computeValueShowTrend } from "../value/readback.js";
+import { LOCAL_SIGNAL_SUMMARY_SCHEMA_VERSION, } from "./payload.js";
+export const DEFAULT_LOCAL_SIGNAL_WINDOW = "30d";
+function parseWindowMs(window) {
+    const match = window.trim().match(/^(\d+)\s*(d|h|m)$/i);
+    if (match === null) {
+        return 30 * 86_400_000;
+    }
+    const amount = Number(match[1]);
+    const unit = match[2]?.toLowerCase();
+    if (unit === "d") {
+        return amount * 86_400_000;
+    }
+    if (unit === "h") {
+        return amount * 3_600_000;
+    }
+    return amount * 60_000;
+}
+function readLastJsonlRecord(path) {
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const lines = readFileSync(path, "utf8")
+            .split("\n")
+            .filter((line) => line.trim().length > 0);
+        const last = lines[lines.length - 1];
+        if (last === undefined) {
+            return null;
+        }
+        const parsed = JSON.parse(last);
+        if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function buildValueFeedbackSummary(projectRoot, windowMs) {
+    const policy = resolveValueFeedback(projectRoot);
+    if (!policy.enabled) {
+        return {
+            enabled: false,
+            total: 0,
+            byClass: { value: 0, bypass: 0, adoption: 0, friction: 0 },
+            topEvents: [],
+        };
+    }
+    const trend = computeValueShowTrend(projectRoot, { windowMs });
+    const topEvents = Object.entries(trend.byEvent)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 5)
+        .map(([name, count]) => ({ name, count }));
+    const byClass = {};
+    for (const key of ["value", "bypass", "adoption", "friction"]) {
+        byClass[key] = trend.byClass[key];
+    }
+    return {
+        enabled: true,
+        total: trend.total,
+        byClass,
+        topEvents,
+    };
+}
+function buildEvalHealthSummary(projectRoot) {
+    const ledgerPath = healthMetricsHistoryPath(projectRoot);
+    if (ledgerPath !== null) {
+        const last = readLastJsonlRecord(ledgerPath);
+        if (last !== null && typeof last.score === "number") {
+            const contradictions = last.contradictions;
+            return {
+                score: last.score,
+                contradictionCount: Array.isArray(contradictions) ? contradictions.length : 0,
+                collectedAt: typeof last.recordedAt === "string" ? last.recordedAt : null,
+            };
+        }
+    }
+    const result = evaluateHealth({ projectRoot, persist: false });
+    if (result.report === null) {
+        return null;
+    }
+    return {
+        score: result.report.score,
+        contradictionCount: result.report.contradictions.length,
+        collectedAt: result.report.recordedAt,
+    };
+}
+function buildHelpedHealthSummary(projectRoot, window) {
+    const windowMs = parseWindowMs(window);
+    const since = Date.now() - windowMs;
+    const helpedPath = helpedMetricsHistoryPath(projectRoot);
+    let helpedCount = 0;
+    if (helpedPath !== null && existsSync(helpedPath)) {
+        try {
+            const lines = readFileSync(helpedPath, "utf8")
+                .split("\n")
+                .filter((l) => l.trim());
+            for (const line of lines) {
+                try {
+                    const rec = JSON.parse(line);
+                    if (rec !== null && typeof rec === "object" && !Array.isArray(rec)) {
+                        const at = rec.recordedAt;
+                        if (typeof at === "string") {
+                            const ts = Date.parse(at);
+                            if (!Number.isNaN(ts) && ts >= since) {
+                                helpedCount += 1;
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // skip bad line
+                }
+            }
+        }
+        catch {
+            helpedCount = 0;
+        }
+    }
+    const healthPath = healthMetricsHistoryPath(projectRoot);
+    let healthEntryCount = 0;
+    if (healthPath !== null && existsSync(healthPath)) {
+        try {
+            const lines = readFileSync(healthPath, "utf8")
+                .split("\n")
+                .filter((l) => l.trim());
+            for (const line of lines) {
+                try {
+                    const rec = JSON.parse(line);
+                    if (rec !== null && typeof rec === "object" && !Array.isArray(rec)) {
+                        const at = rec.recordedAt;
+                        if (typeof at === "string") {
+                            const ts = Date.parse(at);
+                            if (!Number.isNaN(ts) && ts >= since) {
+                                healthEntryCount += 1;
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // skip
+                }
+            }
+        }
+        catch {
+            healthEntryCount = 0;
+        }
+    }
+    return {
+        helpedCount: helpedPath === null ? null : helpedCount,
+        healthEntryCount: healthPath === null ? null : healthEntryCount,
+        window,
+    };
+}
+/** Assemble minimized local ledger summaries (#2693 D15). */
+export function assembleLocalSignalSummary(projectRoot, options = {}) {
+    const window = options.window ?? DEFAULT_LOCAL_SIGNAL_WINDOW;
+    const windowMs = parseWindowMs(window);
+    return {
+        schemaVersion: LOCAL_SIGNAL_SUMMARY_SCHEMA_VERSION,
+        window,
+        valueFeedback: buildValueFeedbackSummary(projectRoot, windowMs),
+        evalHealth: buildEvalHealthSummary(projectRoot),
+        helpedHealth: buildHelpedHealthSummary(projectRoot, window),
+    };
+}
+//# sourceMappingURL=local-signal-summary.js.map

package/dist/product-signal/payload.d.ts

@@ -0,0 +1,90 @@
+import type { ActorNameSource } from "./actor-name.js";
+import type { ProductSignalHarness } from "./install-context.js";
+export declare const PRODUCT_SIGNAL_PAYLOAD_SCHEMA_VERSION: 1;
+export declare const LOCAL_SIGNAL_SUMMARY_SCHEMA_VERSION: 1;
+export declare const SKILLS_SUMMARY_SCHEMA_VERSION: 1;
+export declare const MAX_PAYLOAD_JSON_BYTES = 64000;
+export declare const MAX_HUMAN_ANSWERS = 3;
+export declare const MAX_ANSWER_LENGTH = 2000;
+export declare const MAX_FREE_TEXT_LENGTH = 4000;
+export declare const MAX_AGENT_NOTES_LENGTH = 2000;
+export type ProductSignalSurface = "pulse" | "portrait";
+export interface HumanAnswer {
+    readonly q: string;
+    readonly a: string;
+}
+export interface ProductSignalHuman {
+    readonly nps: number | null;
+    readonly answers: readonly HumanAnswer[];
+    readonly freeText: string | null;
+}
+export interface ValueFeedbackSummary {
+    readonly enabled: boolean;
+    readonly total: number;
+    readonly byClass: {
+        readonly value: number;
+        readonly bypass: number;
+        readonly adoption: number;
+        readonly friction: number;
+    };
+    readonly topEvents: readonly {
+        readonly name: string;
+        readonly count: number;
+    }[];
+}
+export interface EvalHealthSummary {
+    readonly score: number | null;
+    readonly contradictionCount: number | null;
+    readonly collectedAt: string | null;
+}
+export interface HelpedHealthSummary {
+    readonly helpedCount: number | null;
+    readonly healthEntryCount: number | null;
+    readonly window: string;
+}
+export interface LocalSignalSummary {
+    readonly schemaVersion: typeof LOCAL_SIGNAL_SUMMARY_SCHEMA_VERSION;
+    readonly window: string;
+    readonly valueFeedback: ValueFeedbackSummary | null;
+    readonly evalHealth: EvalHealthSummary | null;
+    readonly helpedHealth: HelpedHealthSummary | null;
+}
+export interface SkillsSummaryEntry {
+    readonly skill: string;
+    readonly useCount: number;
+    readonly viewCount: number;
+    readonly lastUsed: string | null;
+}
+export interface SkillsSummary {
+    readonly schemaVersion: typeof SKILLS_SUMMARY_SCHEMA_VERSION;
+    readonly top: readonly SkillsSummaryEntry[];
+    readonly skillCount: number;
+}
+export interface ProductSignalPayload {
+    readonly schemaVersion: typeof PRODUCT_SIGNAL_PAYLOAD_SCHEMA_VERSION;
+    readonly surface: ProductSignalSurface;
+    readonly installId: string;
+    readonly actorName: string;
+    readonly actorNameSource: ActorNameSource;
+    readonly directiveVersion: string;
+    readonly os: string;
+    readonly osVersion: string;
+    readonly shell: string;
+    readonly harness: ProductSignalHarness;
+    readonly harnessVersion: string | null;
+    readonly consentTier: string;
+    readonly consentSource: "user" | "org-policy" | "typed-override";
+    readonly consentVersion: string;
+    readonly human: ProductSignalHuman;
+    readonly agentNotes: string | null;
+    readonly localSignalSummary: LocalSignalSummary | null;
+    readonly skillsSummary: SkillsSummary | null;
+    readonly collectedAt: string;
+}
+/** Client-side payload validation before submit (#2693 D7). */
+export declare function validateProductSignalPayload(payload: ProductSignalPayload): string[];
+/** Optional #829 sidecar path (read-only attach; emit not implemented here). */
+export declare const SKILLS_TELEMETRY_SIDECAR_REL: string;
+/** Read minimized skillsSummary when local sidecar exists (#2693 D14). */
+export declare function readSkillsSummarySidecar(projectRoot: string): SkillsSummary | null;
+//# sourceMappingURL=payload.d.ts.map

package/dist/product-signal/payload.js

@@ -0,0 +1,124 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+export const PRODUCT_SIGNAL_PAYLOAD_SCHEMA_VERSION = 1;
+export const LOCAL_SIGNAL_SUMMARY_SCHEMA_VERSION = 1;
+export const SKILLS_SUMMARY_SCHEMA_VERSION = 1;
+export const MAX_PAYLOAD_JSON_BYTES = 64_000;
+export const MAX_HUMAN_ANSWERS = 3;
+export const MAX_ANSWER_LENGTH = 2_000;
+export const MAX_FREE_TEXT_LENGTH = 4_000;
+export const MAX_AGENT_NOTES_LENGTH = 2_000;
+const SECRET_PATTERNS = [
+    /\bghp_[A-Za-z0-9]{20,}\b/,
+    /\bgithub_pat_[A-Za-z0-9_]{20,}\b/,
+    /\bAKIA[0-9A-Z]{16}\b/,
+    /\bsk-[A-Za-z0-9]{20,}\b/,
+    /\bBearer\s+[A-Za-z0-9._-]{20,}\b/i,
+    /\bBEGIN (?:RSA |EC )?PRIVATE KEY\b/,
+    /\b\.env\b/,
+];
+function containsSecretHygieneViolation(text) {
+    for (const pattern of SECRET_PATTERNS) {
+        if (pattern.test(text)) {
+            return true;
+        }
+    }
+    return false;
+}
+function isValidNps(value) {
+    if (value === null) {
+        return true;
+    }
+    return typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 10;
+}
+/** Client-side payload validation before submit (#2693 D7). */
+export function validateProductSignalPayload(payload) {
+    const errors = [];
+    if (payload.schemaVersion !== PRODUCT_SIGNAL_PAYLOAD_SCHEMA_VERSION) {
+        errors.push(`schemaVersion must be ${PRODUCT_SIGNAL_PAYLOAD_SCHEMA_VERSION}`);
+    }
+    if (payload.surface !== "pulse" && payload.surface !== "portrait") {
+        errors.push("surface must be pulse or portrait");
+    }
+    if (payload.installId.trim().length === 0) {
+        errors.push("installId is required");
+    }
+    if (payload.actorName.trim().length === 0) {
+        errors.push("actorName is required");
+    }
+    if (!isValidNps(payload.human.nps)) {
+        errors.push("human.nps must be null or integer 0-10");
+    }
+    if (payload.human.answers.length > MAX_HUMAN_ANSWERS) {
+        errors.push(`human.answers exceeds max ${MAX_HUMAN_ANSWERS}`);
+    }
+    for (const answer of payload.human.answers) {
+        if (answer.q.length === 0 || answer.a.length === 0) {
+            errors.push("human.answers entries require non-empty q and a");
+        }
+        if (answer.a.length > MAX_ANSWER_LENGTH) {
+            errors.push(`human answer exceeds max length ${MAX_ANSWER_LENGTH}`);
+        }
+    }
+    if (payload.human.freeText !== null && payload.human.freeText.length > MAX_FREE_TEXT_LENGTH) {
+        errors.push(`human.freeText exceeds max length ${MAX_FREE_TEXT_LENGTH}`);
+    }
+    if (payload.agentNotes !== null && payload.agentNotes.length > MAX_AGENT_NOTES_LENGTH) {
+        errors.push(`agentNotes exceeds max length ${MAX_AGENT_NOTES_LENGTH}`);
+    }
+    const serialized = JSON.stringify(payload);
+    if (Buffer.byteLength(serialized, "utf8") > MAX_PAYLOAD_JSON_BYTES) {
+        errors.push(`payload exceeds max size ${MAX_PAYLOAD_JSON_BYTES} bytes`);
+    }
+    if (containsSecretHygieneViolation(serialized)) {
+        errors.push("payload failed secret-hygiene scan");
+    }
+    return errors;
+}
+/** Optional #829 sidecar path (read-only attach; emit not implemented here). */
+export const SKILLS_TELEMETRY_SIDECAR_REL = join(".deft-cache", "skills-telemetry.json");
+/** Read minimized skillsSummary when local sidecar exists (#2693 D14). */
+export function readSkillsSummarySidecar(projectRoot) {
+    const path = resolve(projectRoot, SKILLS_TELEMETRY_SIDECAR_REL);
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return null;
+        }
+        const rec = parsed;
+        const topRaw = rec.top;
+        if (!Array.isArray(topRaw)) {
+            return null;
+        }
+        const top = [];
+        for (const item of topRaw.slice(0, 10)) {
+            if (item === null || typeof item !== "object" || Array.isArray(item)) {
+                continue;
+            }
+            const row = item;
+            const skill = typeof row.skill === "string" ? row.skill.trim() : "";
+            if (skill.length === 0) {
+                continue;
+            }
+            top.push({
+                skill,
+                useCount: typeof row.useCount === "number" ? row.useCount : 0,
+                viewCount: typeof row.viewCount === "number" ? row.viewCount : 0,
+                lastUsed: typeof row.lastUsed === "string" ? row.lastUsed : null,
+            });
+        }
+        const skillCount = typeof rec.skillCount === "number" ? rec.skillCount : top.length;
+        return {
+            schemaVersion: SKILLS_SUMMARY_SCHEMA_VERSION,
+            top,
+            skillCount,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=payload.js.map

package/dist/product-signal/sink-bootstrap.d.ts

@@ -0,0 +1,29 @@
+import { type GhRestSeams } from "../scm/gh-rest.js";
+/** D20 minimum label bootstrap set (#2693). */
+export declare const PRODUCT_SIGNAL_BOOTSTRAP_LABELS: readonly {
+    readonly name: string;
+    readonly color: string;
+    readonly description: string;
+}[];
+export declare const PRODUCT_SIGNAL_SINK_README = "# deftai/product-signal\n\nInternal (org) operator inbox for consented Directive product-improvement signal (Phase 1 under epic #2603).\n\n## Standing threads\n\n- Thread key: `(installId, actorName)` \u2014 see issue body marker `<!-- deft:product-signal v1 ... -->`\n- **Portrait**: one open issue per key; body upserted in place (`surface:portrait`)\n- **Pulse**: dated comments appended on standing issue (`surface:pulse`)\n- **Gap notes**: `Gap:` comments on the pulse thread (`signal:gap` label when present)\n\n## Labels (bootstrapped)\n\n- `surface:pulse`, `surface:portrait`\n- `nps:promoter`, `nps:passive`, `nps:detractor`, `nps:none`\n- `signal:gap`\n- `directive:<major.minor>` \u2014 created on first use per directive version\n\nThis repo is an operator-readable inbox, not the long-term analytics warehouse (#2603).\n";
+export interface BootstrapSinkResult {
+    readonly exitCode: 0 | 1 | 2;
+    readonly stdout: string;
+    readonly repo: string;
+}
+/** Bootstrap D20 labels (idempotent — ignores existing label 422). */
+export declare function bootstrapProductSignalLabels(repo?: string, seams?: GhRestSeams): {
+    created: number;
+    skipped: number;
+    errors: string[];
+};
+/**
+ * Create sink repo + labels via gh CLI (#2693 D6/D20).
+ * Creates as private then sets visibility to **internal** (org-visible, not public).
+ */
+export declare function bootstrapProductSignalSink(options?: {
+    repo?: string;
+    dryRun?: boolean;
+    seams?: GhRestSeams;
+}): BootstrapSinkResult;
+//# sourceMappingURL=sink-bootstrap.d.ts.map

package/dist/product-signal/sink-bootstrap.js

@@ -0,0 +1,108 @@
+import { spawnSync } from "node:child_process";
+import { DEFAULT_PRODUCT_SIGNAL_SINK_REPO } from "../policy/product-signal.js";
+import { GhRestError, restCreateLabel } from "../scm/gh-rest.js";
+/** D20 minimum label bootstrap set (#2693). */
+export const PRODUCT_SIGNAL_BOOTSTRAP_LABELS = [
+    { name: "surface:pulse", color: "1D76DB", description: "Standing pulse thread" },
+    { name: "surface:portrait", color: "5319E7", description: "Standing portrait thread" },
+    { name: "nps:promoter", color: "0E8A16", description: "NPS 9-10" },
+    { name: "nps:passive", color: "FBCA04", description: "NPS 7-8" },
+    { name: "nps:detractor", color: "D93F0B", description: "NPS 0-6" },
+    { name: "nps:none", color: "C5DEF5", description: "No NPS score" },
+    { name: "signal:gap", color: "B60205", description: "Gap comment on pulse thread" },
+];
+export const PRODUCT_SIGNAL_SINK_README = `# deftai/product-signal
+
+Internal (org) operator inbox for consented Directive product-improvement signal (Phase 1 under epic #2603).
+
+## Standing threads
+
+- Thread key: \`(installId, actorName)\` — see issue body marker \`<!-- deft:product-signal v1 ... -->\`
+- **Portrait**: one open issue per key; body upserted in place (\`surface:portrait\`)
+- **Pulse**: dated comments appended on standing issue (\`surface:pulse\`)
+- **Gap notes**: \`Gap:\` comments on the pulse thread (\`signal:gap\` label when present)
+
+## Labels (bootstrapped)
+
+- \`surface:pulse\`, \`surface:portrait\`
+- \`nps:promoter\`, \`nps:passive\`, \`nps:detractor\`, \`nps:none\`
+- \`signal:gap\`
+- \`directive:<major.minor>\` — created on first use per directive version
+
+This repo is an operator-readable inbox, not the long-term analytics warehouse (#2603).
+`;
+/** Bootstrap D20 labels (idempotent — ignores existing label 422). */
+export function bootstrapProductSignalLabels(repo = DEFAULT_PRODUCT_SIGNAL_SINK_REPO, seams = {}) {
+    let created = 0;
+    let skipped = 0;
+    const errors = [];
+    for (const label of PRODUCT_SIGNAL_BOOTSTRAP_LABELS) {
+        try {
+            restCreateLabel(repo, label.name, label.color, label.description, seams);
+            created += 1;
+        }
+        catch (err) {
+            if (err instanceof GhRestError) {
+                if (err.stderr.toLowerCase().includes("already_exists") || err.exitCode === 422) {
+                    skipped += 1;
+                    continue;
+                }
+                errors.push(`${label.name}: ${err.stderr || err.message}`);
+            }
+            else {
+                errors.push(`${label.name}: ${String(err)}`);
+            }
+        }
+    }
+    return { created, skipped, errors };
+}
+/**
+ * Create sink repo + labels via gh CLI (#2693 D6/D20).
+ * Creates as private then sets visibility to **internal** (org-visible, not public).
+ */
+export function bootstrapProductSignalSink(options = {}) {
+    const repo = options.repo ?? DEFAULT_PRODUCT_SIGNAL_SINK_REPO;
+    if (options.dryRun) {
+        return {
+            exitCode: 0,
+            stdout: `[dry-run] would bootstrap internal sink ${repo} with README + ${PRODUCT_SIGNAL_BOOTSTRAP_LABELS.length} labels\n`,
+            repo,
+        };
+    }
+    const create = spawnSync("gh", [
+        "repo",
+        "create",
+        repo,
+        "--private",
+        "--description",
+        "Internal product-improvement signal inbox for Directive partners (Refs #2693)",
+        "--add-readme",
+    ], { encoding: "utf8" });
+    if (create.status !== 0 && !String(create.stderr).toLowerCase().includes("already exists")) {
+        return {
+            exitCode: 2,
+            stdout: `sink bootstrap failed: ${create.stderr || create.stdout}\n`,
+            repo,
+        };
+    }
+    // Org "internal" visibility: gh create has no --internal; set after create.
+    const visibility = spawnSync("gh", ["repo", "edit", repo, "--visibility", "internal", "--accept-visibility-change-consequences"], { encoding: "utf8" });
+    if (visibility.status !== 0) {
+        return {
+            exitCode: 2,
+            stdout: `sink repo created but failed to set visibility=internal: ${visibility.stderr || visibility.stdout}\n`,
+            repo,
+        };
+    }
+    const labelResult = bootstrapProductSignalLabels(repo, options.seams);
+    const lines = [
+        `product-signal sink ${repo} ready (visibility=internal).`,
+        `labels: created=${labelResult.created} skipped=${labelResult.skipped}`,
+    ];
+    if (labelResult.errors.length > 0) {
+        lines.push(`label warnings: ${labelResult.errors.join("; ")}`);
+    }
+    lines.push("", "Update repo README with standing-thread conventions if empty.");
+    return { exitCode: 0, stdout: `${lines.join("\n")}\n`, repo };
+}
+//# sourceMappingURL=sink-bootstrap.js.map

package/dist/product-signal/submit-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { ProductSignalOutcome } from "./gates.js";
+import type { ProductSignalPayload } from "./payload.js";
+export interface SubmitResult {
+    readonly outcome: ProductSignalOutcome;
+    readonly issueUrl?: string | null;
+    readonly issueNumber?: number | null;
+    readonly message: string;
+}
+/** Transport-pluggable submit seam (#2693 D5). */
+export interface SubmitAdapter {
+    readonly id: string;
+    submit(payload: ProductSignalPayload): Promise<SubmitResult>;
+}
+//# sourceMappingURL=submit-adapter.d.ts.map

package/dist/product-signal/submit-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=submit-adapter.js.map

package/dist/product-signal/submit.d.ts

@@ -0,0 +1,54 @@
+import { type ProductSignalOutcome } from "./gates.js";
+import { type ProductSignalHuman, type ProductSignalPayload, type ProductSignalSurface } from "./payload.js";
+export declare const PRODUCT_SIGNAL_LAST_SUBMIT_REL: string;
+export interface ProductSignalSubmitInput {
+    readonly surface: ProductSignalSurface;
+    readonly human?: Partial<ProductSignalHuman>;
+    readonly agentNotes?: string | null;
+    readonly gapText?: string | null;
+}
+export interface ProductSignalSubmitOptions extends ProductSignalSubmitInput {
+    readonly projectRoot?: string | null;
+    readonly dryRun?: boolean;
+    readonly json?: boolean;
+    readonly skipGates?: boolean;
+}
+export interface ProductSignalSubmitResult {
+    readonly outcome: ProductSignalOutcome;
+    readonly exitCode: 0 | 1 | 2;
+    readonly message: string;
+    readonly issueUrl?: string | null;
+    readonly payload?: ProductSignalPayload;
+}
+/** Assemble a versioned product-signal payload (#2693 D7). */
+export declare function assembleProductSignalPayload(projectRoot: string, input: ProductSignalSubmitInput): ProductSignalPayload;
+/** Submit product-signal through gates + adapter (#2693). */
+export declare function submitProductSignal(options: ProductSignalSubmitOptions): Promise<ProductSignalSubmitResult>;
+export declare function runProductSignalStatus(projectRoot: string | null): {
+    exitCode: 0;
+    text: string;
+};
+export declare function runProductSignalEnable(projectRoot: string | null, confirm: boolean): {
+    exitCode: 0 | 1 | 2;
+    text: string;
+};
+export declare function runProductSignalConsent(action: "grant" | "revoke"): {
+    exitCode: 0 | 1;
+    text: string;
+};
+export declare function runProductSignalBootstrapSink(dryRun: boolean): {
+    exitCode: 0 | 1 | 2;
+    text: string;
+};
+export declare function parseProductSignalSubmitArgs(argv: string[]): {
+    surface: ProductSignalSurface;
+    dryRun: boolean;
+    json: boolean;
+    projectRoot: string;
+    nps: number | null;
+    error?: string;
+};
+/** CLI module entrypoint for dispatch (#2693). */
+export declare function productSignalMain(argv?: string[]): Promise<number>;
+export declare function mainEntry(argv?: string[]): Promise<number>;
+//# sourceMappingURL=submit.d.ts.map