lens-content-processor 0.21.3 → 0.24.0

package/dist/parser/survey.js

@@ -0,0 +1,402 @@
+// src/parser/survey.ts
+//
+// Parses post-meeting survey definitions (surveys/ folder). A survey file is
+// frontmatter (required id, optional title) plus flat #### segments, like a
+// lens — but with its own segment vocabulary: Text (prose), Question (free
+// text), Rating (1..N scale), Choice (pick one/many). Answerable segments
+// carry a stable snake_case `key::` that names the answer in
+// survey_responses.payload, so authors can reword a question without
+// breaking response continuity (and the platform can special-case keys like
+// `buddy_texted`).
+//
+// Surveys deliberately do NOT reuse the lens question machinery: there are no
+// correct answers, no AI assessment, and no reveal semantics. Keeping the
+// vocabulary separate also avoids colliding with the quiz `question-type::`
+// syntax if that ever lands on lens questions.
+import { parseFrontmatter } from "./frontmatter.js";
+import { parseSections } from "./sections.js";
+import { validateFrontmatter } from "../validator/validate-frontmatter.js";
+import { detectFieldTypos } from "../validator/field-typos.js";
+import { stripAuthoringMarkup } from "./lens.js";
+import { SURVEY_SEGMENT_SCHEMAS } from "../content-schema.js";
+// Valid segment types for survey H4 headers
+export const SURVEY_SEGMENT_TYPES = new Set([
+    "text",
+    "question",
+    "rating",
+    "choice",
+]);
+/** Keys are payload identifiers: snake_case, stable, short. */
+const KEY_PATTERN = /^[a-z][a-z0-9_]*$/;
+const MAX_KEY_LENGTH = 64;
+const DEFAULT_RATING_SCALE = 5;
+const MIN_RATING_SCALE = 2;
+const MAX_RATING_SCALE = 10;
+function parseBoolField(raw, field, defaultValue) {
+    const value = raw.fields[field];
+    if (value === undefined)
+        return defaultValue;
+    return value.toLowerCase() === "true";
+}
+/**
+ * Read and validate the required content:: prompt of an answerable segment.
+ * Unlike lens Text segments (where empty content degrades to a warning), an
+ * answerable survey segment without a prompt is unusable — hard error.
+ */
+function requirePrompt(raw, file, errors) {
+    const content = raw.fields.content;
+    if (content === undefined || content.trim() === "") {
+        const capitalized = raw.type[0].toUpperCase() + raw.type.slice(1);
+        errors.push({
+            file,
+            line: raw.line,
+            message: `${capitalized} segment is missing content:: (the question shown to the learner)`,
+            suggestion: `Add 'content:: Your question here' to the ${capitalized} segment`,
+            severity: "error",
+        });
+        return null;
+    }
+    return content;
+}
+/** Read and validate the required key:: of an answerable segment. */
+function requireKey(raw, file, errors) {
+    const key = raw.fields.key?.trim();
+    if (!key) {
+        const capitalized = raw.type[0].toUpperCase() + raw.type.slice(1);
+        errors.push({
+            file,
+            line: raw.line,
+            message: `${capitalized} segment is missing key:: (stable identifier for the answer)`,
+            suggestion: "Add a snake_case key, e.g. 'key:: worked_well'. Keys name answers in stored responses — never change one after responses exist",
+            severity: "error",
+        });
+        return null;
+    }
+    if (!KEY_PATTERN.test(key) || key.length > MAX_KEY_LENGTH) {
+        errors.push({
+            file,
+            line: raw.line,
+            message: `Invalid key '${key}' — keys must be snake_case (lowercase letters, digits, underscores; start with a letter; max ${MAX_KEY_LENGTH} chars)`,
+            suggestion: "Example: key:: buddy_texted",
+            severity: "error",
+        });
+        return null;
+    }
+    return key;
+}
+/**
+ * Parse an options:: multiline value into option texts. Plain `- Item` list
+ * items only — survey choices have no correct answers, so checkbox syntax
+ * (`- [ ]` / `- [x]`) is rejected to keep the vocabulary unambiguous.
+ */
+function parseOptions(raw, file, errors) {
+    const value = raw.fields.options;
+    if (value === undefined || value.trim() === "") {
+        errors.push({
+            file,
+            line: raw.line,
+            message: "Choice segment is missing options::",
+            suggestion: "Add a list:\noptions::\n- First option\n- Second option",
+            severity: "error",
+        });
+        return null;
+    }
+    const options = [];
+    for (const line of value.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const checkbox = trimmed.match(/^-\s*\[[ xX]?\]/);
+        if (checkbox) {
+            errors.push({
+                file,
+                line: raw.line,
+                message: `Choice options must be plain list items, got checkbox syntax: "${trimmed}"`,
+                suggestion: "Survey choices have no correct answers — use '- Option text' without brackets",
+                severity: "error",
+            });
+            return null;
+        }
+        const item = trimmed.match(/^-\s+(.+)$/);
+        if (!item) {
+            errors.push({
+                file,
+                line: raw.line,
+                message: `Line in options:: is not a list item: "${trimmed}"`,
+                suggestion: "Every option must be on its own '- Option text' line",
+                severity: "error",
+            });
+            return null;
+        }
+        options.push(item[1].trim());
+    }
+    if (options.length < 2) {
+        errors.push({
+            file,
+            line: raw.line,
+            message: `Choice segment needs at least 2 options, got ${options.length}`,
+            suggestion: "Add more '- Option text' lines under options::",
+            severity: "error",
+        });
+        return null;
+    }
+    return options;
+}
+/** Parse scale:: as an integer in [MIN_RATING_SCALE, MAX_RATING_SCALE]. */
+function parseScale(raw, file, errors) {
+    const value = raw.fields.scale;
+    if (value === undefined)
+        return DEFAULT_RATING_SCALE;
+    const trimmed = value.trim();
+    if (!/^\d+$/.test(trimmed)) {
+        errors.push({
+            file,
+            line: raw.line,
+            message: `Field 'scale' must be an integer, got '${value}'`,
+            suggestion: `Use a number from ${MIN_RATING_SCALE} to ${MAX_RATING_SCALE} (default ${DEFAULT_RATING_SCALE}), or omit the field`,
+            severity: "error",
+        });
+        return null;
+    }
+    const scale = parseInt(trimmed, 10);
+    if (scale < MIN_RATING_SCALE || scale > MAX_RATING_SCALE) {
+        errors.push({
+            file,
+            line: raw.line,
+            message: `Field 'scale' is ${scale}; ratings support ${MIN_RATING_SCALE}–${MAX_RATING_SCALE}`,
+            suggestion: `Use a value from ${MIN_RATING_SCALE} to ${MAX_RATING_SCALE}`,
+            severity: "error",
+        });
+        return null;
+    }
+    return scale;
+}
+/** Parse max-chars:: as a positive integer (optional). */
+function parseMaxChars(raw, file, errors) {
+    const value = raw.fields["max-chars"];
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    if (!/^\d+$/.test(trimmed) || parseInt(trimmed, 10) === 0) {
+        errors.push({
+            file,
+            line: raw.line,
+            message: `Field 'max-chars' must be a positive integer, got '${value}'`,
+            suggestion: "Use a number like 'max-chars:: 500', or remove the field",
+            severity: "error",
+        });
+        return undefined;
+    }
+    return parseInt(trimmed, 10);
+}
+/**
+ * Validate segment fields against the survey schema: unknown fields warn
+ * (with cross-vocabulary hints for lens-only fields), boolean fields must be
+ * true/false. Mirrors validateSegmentFields/validateFieldValues, which are
+ * bound to the lens SEGMENT_SCHEMAS and can't be reused here.
+ */
+function validateSurveySegmentFields(raw, file) {
+    const warnings = [];
+    const schema = SURVEY_SEGMENT_SCHEMAS[raw.type];
+    if (!schema)
+        return warnings;
+    const valid = new Set(schema.allFields);
+    for (const [name, value] of Object.entries(raw.fields)) {
+        if (!valid.has(name)) {
+            const lensOnly = name === "assessment-instructions" ||
+                name === "feedback" ||
+                name === "enforce-voice" ||
+                name === "max-time";
+            warnings.push({
+                file,
+                line: raw.line,
+                message: `Field '${name}' is not valid in a survey ${raw.type} segment`,
+                suggestion: lensOnly
+                    ? `'${name}' belongs to lens questions — survey answers are recorded without AI assessment`
+                    : `Valid fields: ${schema.allFields.join(", ")}`,
+                severity: "warning",
+            });
+        }
+        if (schema.booleanFields.includes(name) &&
+            value.toLowerCase() !== "true" &&
+            value.toLowerCase() !== "false") {
+            warnings.push({
+                file,
+                line: raw.line,
+                message: `Field '${name}' has non-boolean value '${value}'`,
+                suggestion: "Expected 'true' or 'false'",
+                severity: "warning",
+            });
+        }
+    }
+    return warnings;
+}
+function convertSurveySegment(raw, file) {
+    const errors = [];
+    if (raw.title) {
+        const capitalized = raw.type[0].toUpperCase() + raw.type.slice(1);
+        errors.push({
+            file,
+            line: raw.line,
+            message: `Titles are not supported for ${capitalized} segments — use just '#### ${capitalized}'`,
+            suggestion: `Remove the title after '${capitalized}:'`,
+            severity: "error",
+        });
+    }
+    switch (raw.type) {
+        case "text": {
+            const content = raw.fields.content;
+            if (content === undefined) {
+                errors.push({
+                    file,
+                    line: raw.line,
+                    message: "Text segment missing content:: field",
+                    suggestion: "Add 'content:: Your text here' to the text segment",
+                    severity: "error",
+                });
+                return { segment: null, errors };
+            }
+            const segment = { type: "text", content };
+            return { segment, errors };
+        }
+        case "question": {
+            const content = requirePrompt(raw, file, errors);
+            const key = requireKey(raw, file, errors);
+            const maxChars = parseMaxChars(raw, file, errors);
+            if (content === null || key === null)
+                return { segment: null, errors };
+            const segment = {
+                type: "question",
+                key,
+                content,
+                required: parseBoolField(raw, "required", false),
+            };
+            if (maxChars !== undefined)
+                segment.maxChars = maxChars;
+            const placeholder = raw.fields.placeholder?.trim();
+            if (placeholder)
+                segment.placeholder = placeholder;
+            return { segment, errors };
+        }
+        case "rating": {
+            const content = requirePrompt(raw, file, errors);
+            const key = requireKey(raw, file, errors);
+            const scale = parseScale(raw, file, errors);
+            if (content === null || key === null || scale === null) {
+                return { segment: null, errors };
+            }
+            const segment = {
+                type: "rating",
+                key,
+                content,
+                scale,
+                required: parseBoolField(raw, "required", false),
+            };
+            const lowLabel = raw.fields["low-label"]?.trim();
+            const highLabel = raw.fields["high-label"]?.trim();
+            if (lowLabel)
+                segment.lowLabel = lowLabel;
+            if (highLabel)
+                segment.highLabel = highLabel;
+            return { segment, errors };
+        }
+        case "choice": {
+            const content = requirePrompt(raw, file, errors);
+            const key = requireKey(raw, file, errors);
+            const options = parseOptions(raw, file, errors);
+            if (content === null || key === null || options === null) {
+                return { segment: null, errors };
+            }
+            const segment = {
+                type: "choice",
+                key,
+                content,
+                options,
+                multi: parseBoolField(raw, "multi", false),
+                required: parseBoolField(raw, "required", false),
+            };
+            return { segment, errors };
+        }
+        default:
+            // parseSections already errored on unknown types
+            return { segment: null, errors };
+    }
+}
+export function parseSurvey(content, file) {
+    const errors = [];
+    // Strip authoring markup (CriticMarkup + Obsidian comments) before parsing
+    content = stripAuthoringMarkup(content);
+    const frontmatterResult = parseFrontmatter(content, file);
+    if (frontmatterResult.error) {
+        errors.push(frontmatterResult.error);
+        return { survey: null, errors };
+    }
+    const { frontmatter, body, bodyStartLine } = frontmatterResult;
+    const frontmatterErrors = validateFrontmatter(frontmatter, "survey", file);
+    errors.push(...frontmatterErrors);
+    if (frontmatterErrors.some((e) => e.severity === "error")) {
+        return { survey: null, errors };
+    }
+    // id must be a string (YAML might parse UUID-ish values as numbers)
+    if (typeof frontmatter.id !== "string") {
+        errors.push({
+            file,
+            line: 2,
+            message: `Field 'id' must be a string, got ${typeof frontmatter.id}`,
+            suggestion: "Use quotes: id: '12345'",
+            severity: "error",
+        });
+        return { survey: null, errors };
+    }
+    const title = typeof frontmatter.title === "string" ? frontmatter.title : undefined;
+    // Flat H4 segments, same shape as lens bodies
+    const { sections: rawSegments, errors: segmentErrors } = parseSections(body, 3, SURVEY_SEGMENT_TYPES, file, true);
+    for (const error of segmentErrors) {
+        if (error.line)
+            error.line += bodyStartLine - 1;
+    }
+    errors.push(...segmentErrors);
+    const segments = [];
+    const seenKeys = new Map(); // key -> first line
+    for (const rawSeg of rawSegments) {
+        rawSeg.line += bodyStartLine - 1;
+        errors.push(...validateSurveySegmentFields(rawSeg, file));
+        errors.push(...detectFieldTypos(rawSeg.fields, file, rawSeg.line));
+        const { segment, errors: conversionErrors } = convertSurveySegment(rawSeg, file);
+        errors.push(...conversionErrors);
+        if (!segment)
+            continue;
+        if (segment.type !== "text") {
+            const firstLine = seenKeys.get(segment.key);
+            if (firstLine !== undefined) {
+                errors.push({
+                    file,
+                    line: rawSeg.line,
+                    message: `Duplicate key '${segment.key}' (already used at line ${firstLine})`,
+                    suggestion: "Every answerable segment needs a unique key",
+                    severity: "error",
+                });
+                continue;
+            }
+            seenKeys.set(segment.key, rawSeg.line);
+        }
+        segments.push(segment);
+    }
+    if (seenKeys.size === 0) {
+        errors.push({
+            file,
+            line: bodyStartLine,
+            message: "Survey has no answerable segments",
+            suggestion: "Add at least one #### Question, #### Rating, or #### Choice segment",
+            severity: "error",
+        });
+    }
+    if (errors.some((e) => e.severity === "error")) {
+        return { survey: null, errors };
+    }
+    return {
+        survey: { id: frontmatter.id, title, segments },
+        errors,
+    };
+}
+//# sourceMappingURL=survey.js.map

package/dist/parser/survey.js.map

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

package/dist/skill-tree.d.ts

@@ -0,0 +1,83 @@
+import type { ContentError } from "./index.js";
+import type { ParsedLearningOutcome } from "./parser/learning-outcome.js";
+export interface SkillTreeDomain {
+    slug: string;
+    title: string;
+    number: number;
+    /** Stage column the domain's row begins at. Skills staged earlier than
+     * this render inside the start column anyway. Absent = derived by the
+     * frontend from the domain's skills. */
+    startStage?: string;
+}
+export interface TaughtByCourse {
+    slug: string;
+    title: string;
+}
+export interface TaughtByModule {
+    moduleSlug: string;
+    moduleTitle: string;
+    /** Courses whose progression contains this module. A module is always
+     * doable standalone; course membership is context, not a constraint. */
+    courses: TaughtByCourse[];
+}
+export interface SkillTreeCard {
+    /** LO frontmatter id (uuid) — learner progress is keyed on this. */
+    id: string;
+    /** Filename stem; the LO file name is the card title by convention. */
+    title: string;
+    /** Slugs of every domain this skill belongs to — all equals; the first
+     * listed is where dependency edges attach (a drawing detail, not a rank). */
+    domains: string[];
+    stage: string;
+    /** Hard prerequisites, as LO ids. */
+    requires: string[];
+    /** The learner-facing outcome statement, when present. */
+    outcome?: string;
+    /**
+     * A stub that maps territory: positioned on the tree, but with no teaching
+     * content behind it yet. Rendered differently so a map that mixes real and
+     * placeholder material never overstates what exists.
+     */
+    placeholder?: boolean;
+    taughtBy: TaughtByModule[];
+}
+export interface SkillTree {
+    /** Sorted by domain number. */
+    domains: SkillTreeDomain[];
+    cards: SkillTreeCard[];
+    /** LO file paths with no `domain:` field — not yet triaged. */
+    untriaged: string[];
+}
+export declare function slugifyTitle(title: string): string;
+export interface ParsedDomainFile {
+    title: string;
+    number: number;
+    startStage?: string;
+}
+/** Parse a Domains/ placeholder file: `domain-number:` frontmatter is the
+ * only content that matters; the title is the filename. */
+export declare function parseDomainFile(content: string, file: string): {
+    domain: ParsedDomainFile | null;
+    errors: ContentError[];
+};
+export interface SkillTreeInput {
+    /** Domain file path → parsed domain (only successfully parsed ones). */
+    domainFiles: Map<string, ParsedDomainFile>;
+    /** LO file path → parsed LO (only successfully parsed ones). */
+    learningOutcomes: Map<string, ParsedLearningOutcome>;
+    /** LO file path → module file paths whose sections reference it. */
+    moduleLoRefs: Map<string, Set<string>>;
+    /** Module file path → its primary (parent) slug and title. */
+    moduleInfo: Map<string, {
+        slug: string;
+        title: string;
+    }>;
+    /** Module slug → courses containing it. */
+    moduleCourses: Map<string, TaughtByCourse[]>;
+    /** All vault files, for extension-tolerant link resolution. */
+    files: Map<string, string>;
+}
+export declare function buildSkillTree(input: SkillTreeInput): {
+    skillTree: SkillTree;
+    errors: ContentError[];
+};

package/dist/skill-tree.js

@@ -0,0 +1,177 @@
+// src/skill-tree.ts — assembles the skill-tree structure from parsed content.
+//
+// The processor emits relationships (LO ↔ module ↔ course); presentation
+// decisions live in the frontend. Cards reference each other by LO id and
+// reference domains by slug.
+import { parseFrontmatter } from "./parser/frontmatter.js";
+import { findFileWithExtension } from "./parser/wikilink.js";
+export function slugifyTitle(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function fileStem(path) {
+    const base = path.split("/").pop() ?? path;
+    return base.replace(/\.md$/, "");
+}
+/** Parse a Domains/ placeholder file: `domain-number:` frontmatter is the
+ * only content that matters; the title is the filename. */
+export function parseDomainFile(content, file) {
+    const errors = [];
+    const frontmatterResult = parseFrontmatter(content, file);
+    if (frontmatterResult.error) {
+        errors.push(frontmatterResult.error);
+        return { domain: null, errors };
+    }
+    const rawNumber = frontmatterResult.frontmatter["domain-number"];
+    if (typeof rawNumber !== "number" || !Number.isInteger(rawNumber)) {
+        errors.push({
+            file,
+            line: 2,
+            message: `Domain file must have an integer 'domain-number' field, got: ${JSON.stringify(rawNumber)}`,
+            suggestion: "Add domain-number: <n> to the frontmatter",
+            severity: "error",
+        });
+        return { domain: null, errors };
+    }
+    const rawStart = frontmatterResult.frontmatter["start-stage"];
+    let startStage;
+    if (rawStart !== undefined && rawStart !== null) {
+        if (typeof rawStart === "string" &&
+            ["beginner", "intermediate", "advanced"].includes(rawStart)) {
+            startStage = rawStart;
+        }
+        else {
+            errors.push({
+                file,
+                line: 2,
+                message: `Field 'start-stage' must be beginner, intermediate or advanced, got: ${JSON.stringify(rawStart)}`,
+                suggestion: "Use start-stage: beginner | intermediate | advanced",
+                severity: "error",
+            });
+        }
+    }
+    return {
+        domain: {
+            title: fileStem(file),
+            number: rawNumber,
+            ...(startStage ? { startStage } : {}),
+        },
+        errors,
+    };
+}
+export function buildSkillTree(input) {
+    const errors = [];
+    // --- Domains ---
+    const numberToPath = new Map();
+    const pathToDomain = new Map();
+    for (const [path, parsed] of input.domainFiles) {
+        const existing = numberToPath.get(parsed.number);
+        if (existing) {
+            errors.push({
+                file: path,
+                line: 2,
+                message: `Duplicate domain-number ${parsed.number} — already used by ${existing}`,
+                suggestion: "Give each domain file a unique domain-number",
+                severity: "error",
+            });
+            continue;
+        }
+        numberToPath.set(parsed.number, path);
+        pathToDomain.set(path, {
+            slug: slugifyTitle(parsed.title),
+            title: parsed.title,
+            number: parsed.number,
+            ...(parsed.startStage ? { startStage: parsed.startStage } : {}),
+        });
+    }
+    const domains = [...pathToDomain.values()].sort((a, b) => a.number - b.number);
+    // --- Cards ---
+    // First pass: which LO paths become cards (needed to validate requires
+    // edges — an edge must point at another card, not at an excluded or
+    // untriaged LO).
+    const cardPaths = new Map();
+    const untriaged = [];
+    for (const [path, lo] of input.learningOutcomes) {
+        if (lo.domains === undefined) {
+            // Not yet triaged. Reported via skillTree.untriaged (a TODO list for
+            // editors), not as a per-file warning — most LOs were written before
+            // the skill tree existed and blanket warnings would drown /validate.
+            untriaged.push(path);
+            continue;
+        }
+        if (lo.domains === "none")
+            continue;
+        cardPaths.set(path, lo);
+    }
+    untriaged.sort();
+    const cards = [];
+    for (const [path, lo] of cardPaths) {
+        const domainRefs = lo.domains;
+        const domainSlugs = [];
+        for (const domainRef of domainRefs) {
+            const domainPath = findFileWithExtension(domainRef.resolvedPath, input.files);
+            const domain = domainPath ? pathToDomain.get(domainPath) : undefined;
+            if (!domain) {
+                errors.push({
+                    file: path,
+                    line: 2,
+                    message: `Domain link does not resolve to a domain file: ${domainRef.resolvedPath}`,
+                    suggestion: "Check the file name under Domains/",
+                    severity: "error",
+                });
+                continue;
+            }
+            domainSlugs.push(domain.slug);
+        }
+        if (domainSlugs.length === 0)
+            continue;
+        if (lo.stage === undefined)
+            continue; // already reported by the parser
+        const requires = [];
+        for (const ref of lo.requires ?? []) {
+            const targetPath = findFileWithExtension(ref.resolvedPath, input.files);
+            const target = targetPath ? cardPaths.get(targetPath) : undefined;
+            if (!target) {
+                const reason = targetPath
+                    ? "resolves to a Learning Outcome that is not in the skill tree"
+                    : "does not resolve to a Learning Outcome file";
+                errors.push({
+                    file: path,
+                    line: 2,
+                    message: `'requires' link ${reason}: ${ref.resolvedPath}`,
+                    suggestion: "Prerequisite edges must point at another skill-tree Learning Outcome",
+                    severity: "error",
+                });
+                continue;
+            }
+            requires.push(target.id);
+        }
+        const taughtBy = [];
+        for (const modulePath of input.moduleLoRefs.get(path) ?? []) {
+            const info = input.moduleInfo.get(modulePath);
+            if (!info)
+                continue;
+            taughtBy.push({
+                moduleSlug: info.slug,
+                moduleTitle: info.title,
+                courses: input.moduleCourses.get(info.slug) ?? [],
+            });
+        }
+        taughtBy.sort((a, b) => a.moduleSlug.localeCompare(b.moduleSlug));
+        cards.push({
+            id: lo.id,
+            title: fileStem(path),
+            domains: domainSlugs,
+            stage: lo.stage,
+            requires,
+            ...(lo.outcomeStatement ? { outcome: lo.outcomeStatement } : {}),
+            ...(lo.placeholder ? { placeholder: true } : {}),
+            taughtBy,
+        });
+    }
+    cards.sort((a, b) => a.title.localeCompare(b.title));
+    return { skillTree: { domains, cards, untriaged }, errors };
+}
+//# sourceMappingURL=skill-tree.js.map