@alisio/plugin-thesis 0.1.0

package/dist/context.js

@@ -0,0 +1,62 @@
+import { loadProject, runChecks, } from "./checks/index.js";
+import { readState, writeState } from "./storage.js";
+import { thesisRootPath } from "./workspace.js";
+/** A command cannot run yet; the message is the reason, shown to the user as "Blocked: ...". */
+export class Blocked extends Error {
+    constructor(reason) {
+        super(reason);
+        this.name = "Blocked";
+    }
+}
+export async function loadAll(context, workspace, sessionId) {
+    const state = await readState(workspace);
+    if (!state)
+        throw new Error("No thesis workspace here. Run /thesis:init first.");
+    if (state.phase === "intake" || state.pendingQuestions) {
+        throw new Blocked("finish the intake interview first (/thesis:init, /thesis:answer).");
+    }
+    const base = await thesisRootPath(workspace, state.root);
+    const project = await loadProject(base, { ...context.projectOptions, state });
+    const brief = project.brief?.brief;
+    if (!brief)
+        throw new Error("thesis.yaml has errors. Run /thesis:check and fix them first.");
+    return { workspace, sessionId, state, base, project, brief };
+}
+export const saveState = (loaded) => writeState(loaded.workspace, loaded.state);
+/** Re-read the project after files changed, keeping the in-memory state. */
+export async function reload(context, loaded) {
+    loaded.project = await loadProject(loaded.base, {
+        ...context.projectOptions,
+        state: loaded.state,
+    });
+}
+export function gateFindings(loaded, gate, now) {
+    return runChecks(loaded.project, { gates: [gate], now }).findings;
+}
+export const errorsOf = (findings) => findings.filter((finding) => finding.severity === "error");
+export const describeFinding = (finding) => `${finding.code}${finding.file ? ` ${finding.file}${finding.line ? `:${finding.line}` : ""}` : ""}: ${finding.message}`;
+/** Ask one interactive question; undefined when headless or when the user skipped it. */
+export async function askOne(api, label, question) {
+    if (!api.ui.interactive())
+        return undefined;
+    const answers = await api.ui.askQuestions({ label, questions: [question] });
+    const value = answers[question.id];
+    if (typeof value !== "string")
+        return undefined;
+    const text = answers[`${question.id}:text`];
+    return typeof text === "string" && text.trim() ? { value, text: text.trim() } : { value };
+}
+/**
+ * Keep the phase in step with section approvals: all sections approved means review, anything less
+ * means sections. Later phases (final, submitted) are never moved back from here.
+ */
+export function syncPhase(state) {
+    if (state.phase !== "sections" && state.phase !== "review")
+        return;
+    const sections = Object.values(state.sections);
+    state.phase =
+        sections.length > 0 && sections.every((section) => section.status === "approved")
+            ? "review"
+            : "sections";
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/coordinator.d.ts

@@ -0,0 +1,139 @@
+import type { PluginAPI } from "@alisio/sdk";
+import { type SetupDeps } from "./render/adapters/typst-pdf/setup.js";
+import { type BuildOutcome } from "./render/build.js";
+import type { BuildScope } from "./render/model.js";
+import type { RendererRegistry } from "./render/registry.js";
+import { ScholarClient, type ScholarRecord } from "./research/client.js";
+import { type CheckReport } from "./types.js";
+export interface CoordinatorOptions {
+    /** Renderer registry; tests add the test-json adapter here. */
+    registry?: RendererRegistry;
+    /** Test seam for `/thesis:setup` (fetch, process runner, pins). */
+    setupDeps?: Partial<SetupDeps>;
+    /** Test seams; production uses the package defaults. */
+    packsRoot?: string;
+    now?: () => Date;
+    env?: NodeJS.ProcessEnv;
+    /** Scholarly HTTP client; tests inject one backed by recorded fixtures. */
+    scholar?: ScholarClient;
+}
+/** Plain-text build summary shared by the command and the CLI. */
+export declare function formatBuild(outcome: BuildOutcome): string;
+export declare class ThesisCoordinator {
+    private readonly api;
+    private readonly now;
+    private readonly env;
+    private readonly projectOptions;
+    readonly scholar: ScholarClient;
+    private readonly workflow;
+    private readonly registry;
+    private readonly setupDeps;
+    constructor(api: PluginAPI, options?: CoordinatorOptions);
+    private workspace;
+    private requireState;
+    init(args: string, sessionId?: string): Promise<string>;
+    /** Round 4, plus the ICONTEC questions (round 5) when that profile is selected. */
+    private presentationRounds;
+    /** Drive the interview: ask interactively, or park the round as pending questions. */
+    private advance;
+    private park;
+    /** Persist everything a finished round produces: brief, profile, G0, intent, state. */
+    private completeRound;
+    private runG0;
+    private summary;
+    answer(args: string, sessionId?: string): Promise<string>;
+    private nextStep;
+    statusSummary(workspace: string): Promise<Record<string, unknown>>;
+    status(_args: string, sessionId?: string): Promise<string>;
+    check(args: string, sessionId?: string): Promise<string>;
+    /** Read-only variant used by the thesis_check tool: it never writes files. */
+    checkReadOnly(workspace: string, input: {
+        gates?: string[];
+        section?: string;
+    }): Promise<CheckReport>;
+    pack(args: string, sessionId?: string): Promise<string>;
+    style(args: string, sessionId?: string): Promise<string>;
+    norms(args: string, sessionId?: string): Promise<string>;
+    design(args: string, sessionId?: string): Promise<string>;
+    outline(args: string, sessionId?: string): Promise<string>;
+    approve(args: string, sessionId?: string): Promise<string>;
+    revise(args: string, sessionId?: string): Promise<string>;
+    research(args: string, sessionId?: string): Promise<string>;
+    draft(args: string, sessionId?: string): Promise<string>;
+    figure(args: string, sessionId?: string): Promise<string>;
+    review(args: string, sessionId?: string): Promise<string>;
+    finalize(args: string, sessionId?: string): Promise<string>;
+    next(_args: string, sessionId?: string): Promise<string>;
+    /** thesis_scholar_search: structured, sanitized and capped ScholarRecords. */
+    scholarSearch(input: unknown, signal?: AbortSignal): Promise<{
+        results: ScholarRecord[];
+    }>;
+    /** thesis_scholar_resolve: one record with its retraction flag and what verification would say. */
+    scholarResolve(workspace: string | undefined, input: unknown, signal?: AbortSignal): Promise<{
+        identifier: {
+            kind: "url";
+            value: string;
+        };
+        record: null;
+        retraction: {
+            retracted: boolean;
+        };
+        verification: {
+            method: string;
+            officialDomain: string;
+            suggestedStatus: string;
+        };
+    } | {
+        identifier: {
+            kind: "doi";
+            value: string;
+        } | {
+            kind: "arxiv";
+            value: string;
+        } | {
+            kind: "openalex";
+            value: string;
+        };
+        record: null;
+        retraction: {
+            retracted: boolean;
+        };
+        verification: {
+            method: string;
+            officialDomain: string;
+            suggestedStatus: string;
+        };
+    } | {
+        identifier: {
+            kind: "doi";
+            value: string;
+        } | {
+            kind: "arxiv";
+            value: string;
+        } | {
+            kind: "openalex";
+            value: string;
+        };
+        record: ScholarRecord;
+        retraction: {
+            retracted: boolean;
+        };
+        verification: {
+            method: "arxiv" | "crossref" | "openalex";
+            officialDomain: string;
+            suggestedStatus: "CONTEXTUAL_ONLY" | "REJECTED" | "UNVERIFIED" | "VERIFIED_AUTHORITATIVE_GREY" | "VERIFIED_PEER_REVIEWED" | "VERIFIED_PRIMARY";
+        };
+    }>;
+    doctor(): Promise<string>;
+    private cacheRoot;
+    /** Build the thesis and record the result in the state; shared by the command and the tool. */
+    buildRun(workspace: string, input: {
+        scope: BuildScope;
+        section?: string;
+        pdfa?: boolean;
+        format?: string;
+    }, signal?: AbortSignal): Promise<BuildOutcome>;
+    build(args: string, sessionId?: string): Promise<string>;
+    setup(args: string): Promise<string>;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/coordinator.d.ts.map

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