@alisio/plugin-thesis 0.1.0

package/dist/index.js

@@ -0,0 +1,206 @@
+import { definePlugin } from "@alisio/sdk";
+import { ThesisCoordinator } from "./coordinator.js";
+import { resourcePaths } from "./resources.js";
+import { VERSION } from "./version.js";
+export { applyBriefDefaults, isValidLanguageTag, loadBrief, stringifyBrief } from "./brief.js";
+export { cacheRoot } from "./cache.js";
+export { checkRegistry, formatReport, loadProject, parseGates, runChecks } from "./checks/index.js";
+export { detectChrome } from "./chrome/detect.js";
+export { parseClaimsText, serializeClaims } from "./claims.js";
+export { ThesisCoordinator } from "./coordinator.js";
+export { diffProtected } from "./diffguard.js";
+export { formatDoctor, runDoctor } from "./doctor.js";
+export { mapEthicsRequirements, validateEthicsAnswers } from "./policy/ethics.js";
+export { loadOverrides, loadPacks, resolve } from "./policy/resolver.js";
+export { buildThesis } from "./render/build.js";
+export { createDefaultRegistry } from "./render/default-registry.js";
+export * from "./render/index.js";
+export { generateBibtex } from "./research/bibtex.js";
+export { ScholarClient } from "./research/client.js";
+export { loadRoleInstructions, parseResource, resourcePaths, roleSkills } from "./resources.js";
+export { assertRelativePath, atomicWrite, canonicalJson, validateRootName, validateState, } from "./storage.js";
+export * from "./types.js";
+function text(value, isError = false) {
+    return {
+        content: [
+            { type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) },
+        ],
+        ...(isError ? { isError: true } : {}),
+    };
+}
+/** Register the thesis plugin on an API. `options` are test seams; production passes none. */
+export function registerThesis(api, options = {}) {
+    api.resources.agents(resourcePaths.agents);
+    api.resources.skills(resourcePaths.skills);
+    const coordinator = new ThesisCoordinator(api, options);
+    const register = (name, description, argumentHint, handler) => api.commands.register(name, (args, context) => handler(args, context?.sessionId), {
+        description,
+        argumentHint,
+    });
+    register("init", "Create the thesis workspace and run the intake interview", "[dir] [--lang <bcp47>] [--presentation]", coordinator.init.bind(coordinator));
+    register("answer", "Answer pending interview questions headlessly", "-- <id=value ...|json>", coordinator.answer.bind(coordinator));
+    register("status", "Show phase, gates, sections and the next step", "", coordinator.status.bind(coordinator));
+    register("check", "Run the deterministic checks and write the report", "[gate...]", coordinator.check.bind(coordinator));
+    register("pack", "Create, list, check and explain policy packs", "new <scope> <id> | list | check | explain <ruleId|value>", coordinator.pack.bind(coordinator));
+    register("style", "Author, list and check citation styles and presentation profiles", "new <id> -- <guide text|URL|path> | list | check", coordinator.style.bind(coordinator));
+    register("norms", "Turn an institutional guide or rubric into a workspace policy pack", "import -- <guide text|URL|path>", coordinator.norms.bind(coordinator));
+    register("design", "Draft the research protocol and ask Human Gates A and B", "", coordinator.design.bind(coordinator));
+    register("outline", "Draft the section outline and ask the OUTLINE gate", "", coordinator.outline.bind(coordinator));
+    register("approve", "Record a human approval: a gate, a section, a finding, an ethics requirement, norms or a style", "<A|B|OUTLINE|C|SEC-id|FND-id|ETH-id|norms|style:id> [-- notes]", coordinator.approve.bind(coordinator));
+    register("revise", "Send feedback to the role that owns a draft, a section or a review finding", "<A|B|OUTLINE|SEC-id|FND-id|norms|style:id> -- <feedback>", coordinator.revise.bind(coordinator));
+    register("research", "Search, verify and appraise sources for a section and write its dossier", "<SEC-id|next> [-- <search more on ...> | -- add <DOI or URL; title; year; type>]", coordinator.research.bind(coordinator));
+    register("draft", "Draft a section from approved evidence, edit it, check it and ask for approval", "<SEC-id|next> [-- <feedback>]", coordinator.draft.bind(coordinator));
+    register("figure", "Draft a chart, diagram or table for a section", "<SEC-id> -- <request>", coordinator.figure.bind(coordinator));
+    register("review", "Independent review of the built sections; findings go to reviews/", "[SEC-id|all]", coordinator.review.bind(coordinator));
+    register("finalize", "G9 and G10, Human Gate C, PDF/A build and the submission package", "", coordinator.finalize.bind(coordinator));
+    register("build", "Build the thesis PDF (full, approved sections or one section)", "[full|approved|SEC-id] [--pdfa] [--html]", coordinator.build.bind(coordinator));
+    register("setup", "Install the pinned Typst engine into the cache (checksum verified)", "", (args) => coordinator.setup(args));
+    register("next", "Run the next recommended step", "", coordinator.next.bind(coordinator));
+    register("doctor", "Report engines, vendored packages and policy packs", "", () => coordinator.doctor());
+    api.tools.register({
+        name: "thesis_scholar_search",
+        description: "Search OpenAlex, Crossref or arXiv and return structured JSON ScholarRecords. Discovery only: a record is citable only after the coordinator verifies it.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", minLength: 1, maxLength: 512 },
+                source: { type: "string", enum: ["openalex", "crossref", "arxiv"] },
+                limit: { type: "integer", minimum: 1, maximum: 25 },
+                fromYear: { type: "integer", minimum: 1600, maximum: 2200 },
+                toYear: { type: "integer", minimum: 1600, maximum: 2200 },
+                language: { type: "string", pattern: "^[A-Za-z]{2,3}$" },
+            },
+            required: ["query", "source"],
+            additionalProperties: false,
+        },
+        effect: "external",
+        async execute(input, context) {
+            try {
+                return text(await coordinator.scholarSearch(input, context.signal));
+            }
+            catch (error) {
+                return text(error instanceof Error ? error.message : "thesis_scholar_search failed", true);
+            }
+        },
+    });
+    api.tools.register({
+        name: "thesis_scholar_resolve",
+        description: "Resolve a DOI, arXiv id, OpenAlex id (W...) or an official-domain URL to one structured JSON ScholarRecord with its retraction flag and the status verification would assign.",
+        inputSchema: {
+            type: "object",
+            properties: { identifier: { type: "string", minLength: 1, maxLength: 2048 } },
+            required: ["identifier"],
+            additionalProperties: false,
+        },
+        effect: "external",
+        async execute(input, context) {
+            try {
+                return text(await coordinator.scholarResolve(context.workspace, input, context.signal));
+            }
+            catch (error) {
+                return text(error instanceof Error ? error.message : "thesis_scholar_resolve failed", true);
+            }
+        },
+    });
+    api.tools.register({
+        name: "thesis_status",
+        description: "Summarize the thesis workspace: phase, human gates, sections and the next step.",
+        inputSchema: { type: "object", properties: {}, additionalProperties: false },
+        effect: "read",
+        async execute(_input, context) {
+            try {
+                return text(await coordinator.statusSummary(context.workspace));
+            }
+            catch (error) {
+                return text(error instanceof Error ? error.message : "thesis_status failed", true);
+            }
+        },
+    });
+    api.tools.register({
+        name: "thesis_check",
+        description: "Run the deterministic thesis checks and return the CheckReport as JSON. Read-only; use /thesis:check to also write the report.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                gates: {
+                    type: "array",
+                    items: { type: "string", pattern: "^G(0|[1-9]|10)$" },
+                    maxItems: 11,
+                    uniqueItems: true,
+                },
+                section: { type: "string", pattern: "^SEC-\\d{2}(\\.\\d{2}){0,2}$" },
+            },
+            additionalProperties: false,
+        },
+        effect: "read",
+        async execute(input, context) {
+            try {
+                const request = {};
+                if (Array.isArray(input.gates))
+                    request.gates = input.gates.filter((gate) => typeof gate === "string");
+                if (typeof input.section === "string")
+                    request.section = input.section;
+                return text(await coordinator.checkReadOnly(context.workspace, request));
+            }
+            catch (error) {
+                return text(error instanceof Error ? error.message : "thesis_check failed", true);
+            }
+        },
+    });
+    api.tools.register({
+        name: "thesis_build",
+        description: "Build the thesis into a PDF (or report why it cannot). scope full builds everything, approved only approved sections, section needs a section id. Returns JSON with the output path, engine, duration, page count, warnings and errors.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                scope: { type: "string", enum: ["full", "approved", "section"] },
+                section: { type: "string", pattern: "^SEC-\\d{2}(\\.\\d{2}){0,2}$" },
+                format: { type: "string", enum: ["pdf", "html"] },
+                pdfa: { type: "boolean" },
+            },
+            required: ["scope"],
+            additionalProperties: false,
+        },
+        effect: "process",
+        async execute(input, context) {
+            try {
+                const scope = input.scope;
+                if (scope !== "full" && scope !== "approved" && scope !== "section") {
+                    return text("scope must be full, approved or section", true);
+                }
+                const outcome = await coordinator.buildRun(context.workspace, {
+                    scope,
+                    ...(typeof input.section === "string" ? { section: input.section } : {}),
+                    ...(typeof input.format === "string" ? { format: input.format } : {}),
+                    ...(input.pdfa === true ? { pdfa: true } : {}),
+                }, context.signal);
+                return text({
+                    ok: outcome.ok,
+                    path: outcome.path ?? null,
+                    engine: outcome.engine,
+                    ms: outcome.ms,
+                    pages: outcome.pages ?? null,
+                    warnings: outcome.warnings,
+                    errors: outcome.findings.filter((finding) => finding.severity === "error"),
+                }, !outcome.ok);
+            }
+            catch (error) {
+                return text(error instanceof Error ? error.message : "thesis_build failed", true);
+            }
+        },
+    });
+    return coordinator;
+}
+const plugin = definePlugin({
+    id: "thesis",
+    name: "Thesis Studio",
+    description: "Plans, researches, drafts and typesets university theses with verified evidence and deterministic quality gates.",
+    categories: ["methodology-harness"],
+    version: VERSION,
+    apiVersion: 1,
+    setup(api) {
+        registerThesis(api);
+    },
+});
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/intake.d.ts

@@ -0,0 +1,57 @@
+import type { AskQuestionsResult, Question } from "@alisio/sdk";
+import { type Brief, type IntakeState, type PendingQuestions, type ThesisState } from "./types.js";
+export declare const defaultRounds: readonly [1, 2, 3];
+export declare const presentationRound = 4;
+/** Extra presentation questions asked only when the ICONTEC profile is selected (spec 10.3). */
+export declare const icontecRound = 5;
+export declare const roundTitles: Record<number, string>;
+export declare function parseInstitution(text: string): {
+    name: string;
+    faculty: string | null;
+    program: string | null;
+    city: string | null;
+} | undefined;
+/** Questions of one round that are still unanswered (skips answered ones). */
+export declare function buildRound(round: number, answers: Record<string, string>, hint: string): Question[];
+export declare function roundIds(round: number): string[];
+export interface AcceptResult {
+    accepted: Record<string, string>;
+    errors: string[];
+}
+/**
+ * Validate raw answers against the option domain of the given questions. Free text travels under
+ * `<id>:text`. For questions that offer an `other` option, an unknown value is read as that
+ * option's text, so `language=pt-BR` works.
+ */
+export declare function acceptAnswers(questions: readonly Question[], input: Record<string, string>, hint: string): AcceptResult;
+/** Convert an `api.ui.askQuestions` result into the flat string map used for validation. */
+export declare function flattenAnswers(result: AskQuestionsResult): Record<string, string>;
+/**
+ * Parse `/thesis:answer` text: a JSON object, or `id=value` pairs separated by whitespace or
+ * newlines (values run until the next `id=` token). `id:text=...` carries free text.
+ */
+export declare function parseAnswerText(text: string, ids: readonly string[]): Record<string, string>;
+export declare function renderPending(pending: PendingQuestions): string;
+/** Seed answers from the raw fields of a thesis.yaml that already exists. */
+export declare function seedAnswersFromRaw(raw: Record<string, unknown>): Record<string, string>;
+export declare function intakeCountry(answers: Record<string, string>): string | undefined;
+export interface BriefBuildResult {
+    text?: string;
+    brief?: Brief;
+    errors: string[];
+}
+/**
+ * Overlay answered questions on an existing raw brief (or nothing) and produce the full
+ * thesis.yaml. Fields no answer touches keep the user's values.
+ */
+export declare function buildBriefText(answers: Record<string, string>, existing: Record<string, unknown> | undefined, options: {
+    hint: string;
+    year: number;
+}): BriefBuildResult;
+/** The free-text research intent collected in round 3, for the methodologist. */
+export declare function intakeIntent(answers: Record<string, string>): Record<string, string | null>;
+export declare function hintFromEnvironment(env: NodeJS.ProcessEnv): string;
+export declare function isRoundComplete(state: ThesisState | {
+    intake: IntakeState;
+}, round: number): boolean;
+//# sourceMappingURL=intake.d.ts.map

package/dist/intake.d.ts.map

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