@tiangong-ai/cli 0.0.34 → 0.0.36

package/dist/research/workspace/research-policy-wizard.js

@@ -0,0 +1,167 @@
+import { resolve } from "node:path";
+import { CliError } from "../../errors.js";
+import { stringifyJson, write } from "../../io.js";
+import { createResearchSetupWizardTheme, shouldUseResearchSetupWizardColor, TextResearchSetupWizardPrompt, } from "./setup-wizard.js";
+import { resolveVerifiedResearchSetupSkillDirectory } from "./setup.js";
+import { approveResearchPolicy, completeResearchExactJournalPolicy, completeResearchPublicationBrief, initializeResearchPolicy, inspectResearchPolicyCatalog, inspectResearchPolicyStatus, } from "./research-policy.js";
+const ORCHESTRATOR_SKILL_ID = "tiangong.auto-research";
+export async function resolveInstalledResearchPolicySource(rootInput, environment = process.env) {
+    const root = resolve(rootInput);
+    try {
+        return await resolveVerifiedResearchSetupSkillDirectory(root, ORCHESTRATOR_SKILL_ID, environment);
+    }
+    catch (error) {
+        const code = typeof error === "object" && error !== null && "code" in error
+            ? String(error.code)
+            : "RESEARCH_POLICY_SOURCE_REQUIRED";
+        throw new CliError("A verified project-installed tiangong-auto-research orchestrator is required for Research Policy defaults.", {
+            code: "RESEARCH_POLICY_SOURCE_REQUIRED",
+            exitCode: code === "RESEARCH_SETUP_CLI_DRIFT" ? 3 : 2,
+            details: {
+                reasonCode: code,
+                minimumAction: "Run research setup, select the tiangong.auto-research orchestrator for project scope, apply the reviewed plan, and reach READY.",
+                retryCommand: `tiangong-ai research setup --workspace ${root}`,
+            },
+        });
+    }
+}
+export async function executeResearchPolicyWizard(input) {
+    const root = resolve(input.root);
+    const sourceRoot = input.sourceRoot ??
+        (await resolveInstalledResearchPolicySource(root, input.environment ?? process.env));
+    const catalog = await inspectResearchPolicyCatalog(sourceRoot);
+    input.prompt.note("Top-journal Research Policy", "brand");
+    input.prompt.note("The bundled policies are generic defaults, not evidence of target-journal fit or acceptance. Review and customize them for the field, article type, and current official journal guidance.", "warning");
+    const articleType = await selectCatalogValue(input.prompt, "Article type", catalog.categories.articleTypes);
+    const field = await selectCatalogValue(input.prompt, "Research field", catalog.categories.fields);
+    const journalClass = await selectCatalogValue(input.prompt, "Target journal class", catalog.categories.journalClasses);
+    const includeExactJournal = await input.prompt.confirm("Add and fully customize an exact target-journal policy now?", false);
+    await initializeResearchPolicy({
+        root,
+        projectId: input.projectId,
+        sourceRoot,
+        articleType,
+        field,
+        journalClass,
+        includeExactJournalTemplate: includeExactJournal,
+    });
+    const centralQuestion = await requiredPolicyInput(input.prompt, "Central research question", 8);
+    const centralClaim = await requiredPolicyInput(input.prompt, "Central claim", 8);
+    const centralOutcome = await requiredPolicyInput(input.prompt, "Central outcome", 3);
+    const contributionType = await requiredPolicyInput(input.prompt, "Contribution type", 3);
+    let targetJournal = null;
+    if (includeExactJournal) {
+        targetJournal = await requiredPolicyInput(input.prompt, "Exact target journal", 2);
+        const officialGuidelinesUrl = await requiredPolicyInput(input.prompt, "Official journal guidelines HTTPS URL", 10);
+        const officialGuidelinesRetrievedAt = await requiredPolicyInput(input.prompt, "Official guidelines retrieval date (YYYY-MM-DD)", 10, new Date().toISOString().slice(0, 10));
+        await completeResearchExactJournalPolicy(root, input.projectId, {
+            journalName: targetJournal,
+            officialGuidelinesUrl,
+            officialGuidelinesRetrievedAt,
+            scope: await requiredPolicyInput(input.prompt, "Journal scope and audience", 12),
+            editorialSignificance: await requiredPolicyInput(input.prompt, "Journal editorial significance threshold", 12),
+            evidenceExpectations: await requiredPolicyInput(input.prompt, "Journal evidence expectations", 12),
+            methodsAndValidation: await requiredPolicyInput(input.prompt, "Journal methods and validation requirements", 12),
+            reproducibility: await requiredPolicyInput(input.prompt, "Journal reproducibility requirements", 12),
+            deskRejectTriggers: await requiredPolicyInput(input.prompt, "Journal desk-reject triggers", 12),
+            requiredReviewerQuestions: await requiredPolicyInput(input.prompt, "Journal-specific reviewer questions", 12),
+            permittedPivots: await requiredPolicyInput(input.prompt, "Permitted research or journal pivots", 12),
+        });
+    }
+    let status = await completeResearchPublicationBrief(root, input.projectId, {
+        centralQuestion,
+        centralClaim,
+        centralOutcome,
+        contributionType,
+        targetJournal,
+    });
+    input.prompt.note(`Draft created at ${status.policyDirectory}. Review every policy document before approval.`, "summary");
+    let approved = false;
+    const acknowledgeDefaults = await input.prompt.confirm("I acknowledge that the remaining bundled defaults are generic and do not establish journal acceptance", false);
+    if (acknowledgeDefaults) {
+        approved = await input.prompt.confirm("Approve this exact Research Policy hash for top-journal execution?", false);
+    }
+    if (approved) {
+        status = await approveResearchPolicy(root, input.projectId, {
+            confirm: true,
+            acknowledgeDefaults: true,
+        });
+        input.prompt.note(`Approved exact policy hash ${status.resolvedPolicySha256}. Any later edit invalidates this approval.`, "success");
+    }
+    else {
+        status = await inspectResearchPolicyStatus(root, input.projectId);
+        input.prompt.note("Policy remains a draft. Customize it, then approve the exact changed hash before project initialization.", "warning");
+    }
+    return {
+        schemaVersion: 1,
+        projectId: input.projectId,
+        sourceRoot,
+        defaultsInUse: status.defaultDocuments > 0,
+        approved,
+        status,
+        next: approved
+            ? {
+                action: "initialize-top-journal-project",
+                minimumAction: "Initialize the project with --goal top-journal and this policy project ID.",
+                retryCommand: `tiangong-ai research project init ${input.projectId} --question <research-question> --goal top-journal --workspace ${root} --help`,
+            }
+            : {
+                action: "customize-and-approve",
+                minimumAction: "Review the policy directory and approve the exact resulting hash.",
+                retryCommand: `tiangong-ai research policy approve ${input.projectId} --confirm --acknowledge-defaults --workspace ${root}`,
+            },
+    };
+}
+export async function runInteractiveResearchPolicyWizard(input) {
+    const sourceRoot = await resolveInstalledResearchPolicySource(input.root, input.io.env);
+    if (!input.io.stdin?.isTTY) {
+        throw new CliError("Interactive Research Policy setup requires a TTY.", {
+            code: "RESEARCH_POLICY_TTY_REQUIRED",
+            exitCode: 2,
+            details: {
+                minimumAction: "Run the Policy Wizard in a terminal, or use policy catalog/init/status/approve for automation.",
+                retryCommand: "tiangong-ai research policy wizard --help",
+            },
+        });
+    }
+    const prompt = new TextResearchSetupWizardPrompt(input.io.stdin, input.io.stderr, createResearchSetupWizardTheme(shouldUseResearchSetupWizardColor({
+        outputIsTTY: Boolean(input.io.stderr.isTTY),
+        json: input.json,
+        environment: input.io.env,
+    })));
+    try {
+        const result = await executeResearchPolicyWizard({
+            root: input.root,
+            projectId: input.projectId,
+            prompt,
+            sourceRoot,
+            environment: input.io.env,
+        });
+        write(input.io.stdout, stringifyJson(result, input.json));
+        return 0;
+    }
+    finally {
+        prompt.close();
+    }
+}
+async function selectCatalogValue(prompt, label, values) {
+    if (!values.length) {
+        throw new CliError(`Research Policy catalog has no ${label.toLowerCase()} options.`, {
+            code: "RESEARCH_POLICY_SOURCE_INVALID",
+            exitCode: 2,
+        });
+    }
+    return prompt.select(label, values.map((value) => ({ value, label: value })), values[0]);
+}
+async function requiredPolicyInput(prompt, label, minimumBytes, defaultValue = "") {
+    const value = (await prompt.input(label, defaultValue)).trim();
+    if (Buffer.byteLength(value, "utf8") < minimumBytes) {
+        throw new CliError(`${label} is required and must be explicit.`, {
+            code: "RESEARCH_POLICY_INVALID",
+            exitCode: 2,
+            details: { field: label },
+        });
+    }
+    return value;
+}
+//# sourceMappingURL=research-policy-wizard.js.map

package/dist/research/workspace/research-policy-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-policy-wizard.js","sourceRoot":"","sources":["../../../src/research/workspace/research-policy-wizard.ts"],"names":[],"mappings":"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"}

package/dist/research/workspace/research-policy.d.ts

@@ -0,0 +1,70 @@
+import type { ResearchPolicyBinding, ResearchVerdictCeiling } from "./types.js";
+export type ResearchPolicyStatusKind = "missing" | "default-unapproved" | "default-approved" | "custom-draft" | "custom-approved" | "conflict" | "stale" | "changed" | "invalid";
+export interface ResearchPolicyStatus {
+    schemaVersion: 1;
+    projectId: string;
+    status: ResearchPolicyStatusKind;
+    policyDirectory: string;
+    defaultDocuments: number;
+    customDocuments: number;
+    invalidDocuments: string[];
+    conflicts: string[];
+    approvedAt: string | null;
+    expiresAt: string | null;
+    resolvedPolicySha256: string | null;
+    verdictCeiling: ResearchVerdictCeiling | null;
+    targetJournal: string | null;
+    guidance: string;
+}
+export declare function inspectResearchPolicyCatalog(sourceRoot: string): Promise<{
+    schemaVersion: 1;
+    sourceTreeSha256: string;
+    categories: {
+        articleTypes: string[];
+        fields: string[];
+        journalClasses: string[];
+    };
+    defaults: {
+        baseline: string;
+        reviewers: string[];
+        publicationBrief: string;
+    };
+}>;
+export declare function initializeResearchPolicy(input: {
+    root: string;
+    projectId: string;
+    sourceRoot: string;
+    articleType: string;
+    field: string;
+    journalClass: string;
+    includeExactJournalTemplate?: boolean;
+}): Promise<ResearchPolicyStatus>;
+export declare function completeResearchPublicationBrief(rootInput: string, projectId: string, input: {
+    centralQuestion: string;
+    centralClaim: string;
+    centralOutcome: string;
+    contributionType: string;
+    targetJournal?: string | null;
+}): Promise<ResearchPolicyStatus>;
+export declare function completeResearchExactJournalPolicy(rootInput: string, projectId: string, input: {
+    journalName: string;
+    officialGuidelinesUrl: string;
+    officialGuidelinesRetrievedAt: string;
+    scope: string;
+    editorialSignificance: string;
+    evidenceExpectations: string;
+    methodsAndValidation: string;
+    reproducibility: string;
+    deskRejectTriggers: string;
+    requiredReviewerQuestions: string;
+    permittedPivots: string;
+}): Promise<ResearchPolicyStatus>;
+export declare function inspectResearchPolicyStatus(rootInput: string, projectId: string, options?: {
+    now?: Date;
+}): Promise<ResearchPolicyStatus>;
+export declare function approveResearchPolicy(rootInput: string, projectId: string, options: {
+    confirm: boolean;
+    acknowledgeDefaults?: boolean;
+}): Promise<ResearchPolicyStatus>;
+export declare function loadApprovedResearchPolicy(root: string, projectId: string): Promise<ResearchPolicyBinding>;
+export declare function assertResearchPolicyBinding(root: string, binding: ResearchPolicyBinding): Promise<void>;