@deftai/directive-core 0.80.0 → 0.81.0

package/dist/product-signal/submit.js

@@ -0,0 +1,290 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { enableProductSignal, formatProductSignalStatusLine, resolveProductSignal, } from "../policy/product-signal.js";
+import { resolveProjectRoot } from "../scope/project-context.js";
+import { resolveActorName } from "./actor-name.js";
+import { grantProductSignalConsent, isProductSignalConsented, readProductSignalConsent, revokeProductSignalConsent, } from "./consent.js";
+import { evaluateProductSignalGates } from "./gates.js";
+import { GitHubPrivateSinkAdapter } from "./github-private-sink-adapter.js";
+import { collectInstallContext } from "./install-context.js";
+import { assembleLocalSignalSummary } from "./local-signal-summary.js";
+import { PRODUCT_SIGNAL_PAYLOAD_SCHEMA_VERSION, readSkillsSummarySidecar, validateProductSignalPayload, } from "./payload.js";
+import { bootstrapProductSignalSink } from "./sink-bootstrap.js";
+export const PRODUCT_SIGNAL_LAST_SUBMIT_REL = join(".deft-cache", "product-signal-last-submit.json");
+function recordLastSubmit(projectRoot, outcome, url) {
+    const path = resolve(projectRoot, PRODUCT_SIGNAL_LAST_SUBMIT_REL);
+    try {
+        mkdirSync(join(path, ".."), { recursive: true });
+        appendFileSync(path, `${JSON.stringify({
+            outcome,
+            issueUrl: url,
+            at: new Date().toISOString().replace(/\.\d{3}Z$/, "Z"),
+        })}\n`, "utf8");
+    }
+    catch {
+        // observability only
+    }
+}
+function readLastSubmitSummary(projectRoot) {
+    const path = resolve(projectRoot, PRODUCT_SIGNAL_LAST_SUBMIT_REL);
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const lines = readFileSync(path, "utf8")
+            .split("\n")
+            .filter((l) => l.trim());
+        const last = lines[lines.length - 1];
+        if (!last) {
+            return null;
+        }
+        const rec = JSON.parse(last);
+        if (rec !== null && typeof rec === "object" && !Array.isArray(rec)) {
+            const at = rec.at;
+            const outcome = rec.outcome;
+            const url = rec.issueUrl;
+            return `last=${String(outcome)} at=${String(at)} url=${String(url ?? "none")}`;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/** Assemble a versioned product-signal payload (#2693 D7). */
+export function assembleProductSignalPayload(projectRoot, input) {
+    const ctx = collectInstallContext(projectRoot);
+    const actor = resolveActorName({ projectRoot });
+    const consent = readProductSignalConsent();
+    const human = {
+        nps: input.human?.nps ?? null,
+        answers: input.human?.answers ?? [],
+        freeText: input.human?.freeText ?? null,
+    };
+    return {
+        schemaVersion: PRODUCT_SIGNAL_PAYLOAD_SCHEMA_VERSION,
+        surface: input.surface,
+        installId: ctx.installId,
+        actorName: actor.displayName,
+        actorNameSource: actor.actorNameSource,
+        directiveVersion: ctx.directiveVersion,
+        os: ctx.os,
+        osVersion: ctx.osVersion,
+        shell: ctx.shell,
+        harness: ctx.harness,
+        harnessVersion: ctx.harnessVersion,
+        consentTier: consent?.tier ?? "none",
+        consentSource: "user",
+        consentVersion: consent ? String(consent.consentVersion) : "0",
+        human,
+        agentNotes: input.agentNotes ?? null,
+        localSignalSummary: assembleLocalSignalSummary(projectRoot),
+        skillsSummary: readSkillsSummarySidecar(projectRoot),
+        collectedAt: new Date().toISOString().replace(/\.\d{3}Z$/, "Z"),
+    };
+}
+/** Submit product-signal through gates + adapter (#2693). */
+export async function submitProductSignal(options) {
+    const root = resolveProjectRoot(options.projectRoot ?? undefined);
+    if (root === null) {
+        return { outcome: "error-config", exitCode: 2, message: "project root not found\n" };
+    }
+    if (!options.skipGates) {
+        const gates = evaluateProductSignalGates({ projectRoot: root });
+        if (!gates.allowed) {
+            return { outcome: gates.outcome, exitCode: 0, message: `${gates.message}\n` };
+        }
+    }
+    const payload = assembleProductSignalPayload(root, options);
+    const validationErrors = validateProductSignalPayload(payload);
+    if (validationErrors.length > 0) {
+        return {
+            outcome: "validation",
+            exitCode: 1,
+            message: `validation failed: ${validationErrors.join("; ")}\n`,
+            payload,
+        };
+    }
+    if (options.dryRun) {
+        return {
+            outcome: "dry-run",
+            exitCode: 0,
+            message: `[dry-run] payload valid for ${payload.surface}\n`,
+            payload,
+        };
+    }
+    const policy = resolveProductSignal(root);
+    const adapter = new GitHubPrivateSinkAdapter({ sinkRepo: policy.sinkRepo });
+    const result = await adapter.submit(payload, { gapText: options.gapText });
+    if (result.outcome === "submitted") {
+        recordLastSubmit(root, result.outcome, result.issueUrl ?? null);
+    }
+    const urlLine = result.issueUrl ? ` url=${result.issueUrl}` : "";
+    return {
+        outcome: result.outcome,
+        exitCode: 0,
+        message: `${result.message}${urlLine}\n`,
+        issueUrl: result.issueUrl,
+        payload,
+    };
+}
+export function runProductSignalStatus(projectRoot) {
+    const root = resolveProjectRoot(projectRoot ?? undefined) ?? process.cwd();
+    const policy = resolveProductSignal(root);
+    const consented = isProductSignalConsented();
+    const last = readLastSubmitSummary(root);
+    const lines = [
+        formatProductSignalStatusLine(policy),
+        `[deft product-signal] consented=${String(consented)}`,
+        last ? `[deft product-signal] ${last}` : "[deft product-signal] last submit: none",
+    ];
+    return { exitCode: 0, text: `${lines.join("\n")}\n` };
+}
+export function runProductSignalEnable(projectRoot, confirm) {
+    const root = resolveProjectRoot(projectRoot ?? undefined);
+    if (root === null) {
+        return { exitCode: 2, text: "project root not found\n" };
+    }
+    const result = enableProductSignal(root, { confirm });
+    return { exitCode: result.exitCode, text: result.stdout };
+}
+export function runProductSignalConsent(action) {
+    if (action === "grant") {
+        const record = grantProductSignalConsent();
+        return {
+            exitCode: 0,
+            text: `product-signal consent granted (tier=${record.tier}, version=${record.consentVersion}).\n`,
+        };
+    }
+    const ok = revokeProductSignalConsent();
+    if (!ok) {
+        return { exitCode: 1, text: "no consent file to revoke\n" };
+    }
+    return { exitCode: 0, text: "product-signal consent revoked\n" };
+}
+export function runProductSignalBootstrapSink(dryRun) {
+    const result = bootstrapProductSignalSink({ dryRun });
+    return { exitCode: result.exitCode, text: result.stdout };
+}
+export function parseProductSignalSubmitArgs(argv) {
+    let surface = "pulse";
+    let dryRun = false;
+    let json = false;
+    let projectRoot = ".";
+    let nps = null;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--surface") {
+            const v = argv[i + 1];
+            if (v !== "pulse" && v !== "portrait") {
+                return { surface, dryRun, json, projectRoot, nps, error: "invalid --surface" };
+            }
+            surface = v;
+            i += 1;
+        }
+        else if (arg?.startsWith("--surface=")) {
+            const v = arg.slice("--surface=".length);
+            if (v !== "pulse" && v !== "portrait") {
+                return { surface, dryRun, json, projectRoot, nps, error: "invalid --surface" };
+            }
+            surface = v;
+        }
+        else if (arg === "--dry-run") {
+            dryRun = true;
+        }
+        else if (arg === "--json") {
+            json = true;
+        }
+        else if (arg === "--nps") {
+            const v = Number(argv[i + 1]);
+            if (!Number.isInteger(v) || v < 0 || v > 10) {
+                return { surface, dryRun, json, projectRoot, nps, error: "invalid --nps" };
+            }
+            nps = v;
+            i += 1;
+        }
+        else if (arg === "--project-root") {
+            projectRoot = argv[i + 1] ?? ".";
+            i += 1;
+        }
+        else if (arg?.startsWith("--project-root=")) {
+            projectRoot = arg.slice("--project-root=".length);
+        }
+        else {
+            return { surface, dryRun, json, projectRoot, nps, error: `unrecognized argument: ${arg}` };
+        }
+    }
+    return { surface, dryRun, json, projectRoot, nps };
+}
+/** CLI module entrypoint for dispatch (#2693). */
+export async function productSignalMain(argv = process.argv.slice(2)) {
+    const sub = argv[0];
+    if (sub === "status") {
+        const rootIdx = argv.indexOf("--project-root");
+        const root = rootIdx >= 0
+            ? (argv[rootIdx + 1] ?? ".")
+            : (argv.find((a) => a.startsWith("--project-root="))?.split("=")[1] ?? ".");
+        const result = runProductSignalStatus(root);
+        process.stdout.write(result.text);
+        return result.exitCode;
+    }
+    if (sub === "enable") {
+        const confirm = argv.includes("--confirm");
+        const rootIdx = argv.indexOf("--project-root");
+        const root = rootIdx >= 0
+            ? (argv[rootIdx + 1] ?? ".")
+            : (argv.find((a) => a.startsWith("--project-root="))?.split("=")[1] ?? ".");
+        const result = runProductSignalEnable(root, confirm);
+        process.stdout.write(result.text);
+        return result.exitCode;
+    }
+    if (sub === "consent") {
+        const grant = argv.includes("--grant");
+        const revoke = argv.includes("--revoke");
+        if (grant === revoke) {
+            process.stderr.write("usage: product-signal consent -- --grant|--revoke\n");
+            return 1;
+        }
+        const result = runProductSignalConsent(grant ? "grant" : "revoke");
+        process.stdout.write(result.text);
+        return result.exitCode;
+    }
+    if (sub === "bootstrap-sink") {
+        const result = runProductSignalBootstrapSink(argv.includes("--dry-run"));
+        process.stdout.write(result.text);
+        return result.exitCode;
+    }
+    if (sub === "submit") {
+        const parsed = parseProductSignalSubmitArgs(argv.slice(1));
+        if (parsed.error) {
+            process.stderr.write(`${parsed.error}\n`);
+            return 1;
+        }
+        const result = await submitProductSignal({
+            projectRoot: parsed.projectRoot,
+            surface: parsed.surface,
+            dryRun: parsed.dryRun,
+            json: parsed.json,
+            human: parsed.nps !== null ? { nps: parsed.nps, answers: [], freeText: null } : undefined,
+        });
+        if (parsed.json) {
+            process.stdout.write(`${JSON.stringify({
+                outcome: result.outcome,
+                exit_code: result.exitCode,
+                message: result.message.trim(),
+                issue_url: result.issueUrl ?? null,
+                payload: result.payload ?? null,
+            }, null, 2)}\n`);
+        }
+        else {
+            process.stdout.write(result.message);
+        }
+        return result.exitCode;
+    }
+    process.stderr.write("usage: product-signal [status|enable|consent|submit|bootstrap-sink] ...\n");
+    return 1;
+}
+export async function mainEntry(argv = process.argv.slice(2)) {
+    return productSignalMain(argv);
+}
+//# sourceMappingURL=submit.js.map

package/dist/scm/gh-rest.d.ts

@@ -53,9 +53,11 @@ export interface RestIssueListOptions {
 export declare function restIssueList(repo: string, options?: RestIssueListOptions, seams?: GhRestSeams): Record<string, unknown>[];
 export declare const REST_MAX_PER_PAGE = 100;
 export declare const REST_PAGINATION_MAX_PAGES = 100;
-export declare const PUBLIC_HELPERS: readonly ["restCreateIssue", "restPostComment", "restCloseIssue", "restOpenPr", "restMergePr", "restIssueView", "restPrView", "restIssueList", "restIssueListPaginated"];
+export declare const PUBLIC_HELPERS: readonly ["restCreateIssue", "restPostComment", "restUpdateIssue", "restCreateLabel", "restCloseIssue", "restOpenPr", "restMergePr", "restIssueView", "restPrView", "restIssueList", "restIssueListPaginated"];
 export declare function restCreateIssue(repo: string, title: string, body: string, labels?: readonly string[], seams?: GhRestSeams): Record<string, unknown>;
 export declare function restPostComment(repo: string, n: number, body: string, seams?: GhRestSeams): Record<string, unknown>;
+export declare function restUpdateIssue(repo: string, n: number, patch: Record<string, unknown>, seams?: GhRestSeams): Record<string, unknown>;
+export declare function restCreateLabel(repo: string, name: string, color: string, description: string, seams?: GhRestSeams): Record<string, unknown>;
 export declare function restCloseIssue(repo: string, n: number, reason?: string | null, seams?: GhRestSeams): Record<string, unknown>;
 export declare function restOpenPr(repo: string, head: string, base: string, title: string, body: string, options?: {
     draft?: boolean;

package/dist/scm/gh-rest.js

@@ -171,6 +171,8 @@ export const REST_PAGINATION_MAX_PAGES = 100;
 export const PUBLIC_HELPERS = [
     "restCreateIssue",
     "restPostComment",
+    "restUpdateIssue",
+    "restCreateLabel",
     "restCloseIssue",
     "restOpenPr",
     "restMergePr",
@@ -224,6 +226,26 @@ export function restPostComment(repo, n, body, seams = {}) {
         ...seams,
     });
 }
+export function restUpdateIssue(repo, n, patch, seams = {}) {
+    const [owner, name] = splitRepo(repo);
+    const endpoint = `repos/${owner}/${name}/issues/${n}`;
+    return execMutation([endpoint, "--method", "PATCH"], {
+        endpoint,
+        payload: patch,
+        hint: "verify repo permissions and issue number; check gh auth status",
+        ...seams,
+    });
+}
+export function restCreateLabel(repo, name, color, description, seams = {}) {
+    const [owner, repoName] = splitRepo(repo);
+    const endpoint = `repos/${owner}/${repoName}/labels`;
+    return execMutation([endpoint, "--method", "POST"], {
+        endpoint,
+        payload: { name, color, description },
+        hint: "verify repo permissions; label may already exist (422 is acceptable for idempotent bootstrap)",
+        ...seams,
+    });
+}
 export function restCloseIssue(repo, n, reason = "completed", seams = {}) {
     const [owner, name] = splitRepo(repo);
     const endpoint = `repos/${owner}/${name}/issues/${n}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -309,8 +309,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.80.0",
-    "@deftai/directive-types": "^0.80.0",
+    "@deftai/directive-content": "^0.81.0",
+    "@deftai/directive-types": "^0.81.0",
     "archiver": "^8.0.0"
   },
   "scripts": {