@khorsheed/dsh-library 0.0.0-stage → 0.1.0

package/lib/types/remote.js

@@ -0,0 +1,332 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+/** The wire namespace is `library`: the browser calls `remote.library.*`. */
+let LibraryRemoteService = (() => {
+    let _classSuper = TypertRemoteService;
+    let _instanceExtraInitializers = [];
+    let _capabilities_decorators;
+    let _listProjects_decorators;
+    let _getProject_decorators;
+    let _createProject_decorators;
+    let _updateProject_decorators;
+    let _deleteProject_decorators;
+    let _getResource_decorators;
+    let _listResources_decorators;
+    let _putResource_decorators;
+    let _setBookKind_decorators;
+    let _moveResource_decorators;
+    let _removeResource_decorators;
+    let _getRoadmap_decorators;
+    let _adoptRoadmap_decorators;
+    let _discardDraft_decorators;
+    let _markNodeRead_decorators;
+    let _listPages_decorators;
+    let _readPagePhoto_decorators;
+    let _savePhoto_decorators;
+    let _recordPage_decorators;
+    let _listCards_decorators;
+    let _dueCards_decorators;
+    let _writeCards_decorators;
+    let _editCard_decorators;
+    let _undoCards_decorators;
+    let _reviewCard_decorators;
+    let _listAssessments_decorators;
+    let _getAssessment_decorators;
+    let _putAttempt_decorators;
+    let _listAttempts_decorators;
+    let _boundTarget_decorators;
+    let _bindTarget_decorators;
+    let _listEvents_decorators;
+    let _recentChanges_decorators;
+    let _createRetake_decorators;
+    let _recentRecords_decorators;
+    let _latestActivity_decorators;
+    let _stats_decorators;
+    return class LibraryRemoteService extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _capabilities_decorators = [Remote('capabilities')];
+            _listProjects_decorators = [Remote('listProjects')];
+            _getProject_decorators = [Remote('getProject')];
+            _createProject_decorators = [Remote('createProject')];
+            _updateProject_decorators = [Remote('updateProject')];
+            _deleteProject_decorators = [Remote('deleteProject')];
+            _getResource_decorators = [Remote('getResource')];
+            _listResources_decorators = [Remote('listResources')];
+            _putResource_decorators = [Remote('putResource')];
+            _setBookKind_decorators = [Remote('setBookKind')];
+            _moveResource_decorators = [Remote('moveResource')];
+            _removeResource_decorators = [Remote('removeResource')];
+            _getRoadmap_decorators = [Remote('getRoadmap')];
+            _adoptRoadmap_decorators = [Remote('adoptRoadmap')];
+            _discardDraft_decorators = [Remote('discardDraft')];
+            _markNodeRead_decorators = [Remote('markNodeRead')];
+            _listPages_decorators = [Remote('listPages')];
+            _readPagePhoto_decorators = [Remote('readPagePhoto')];
+            _savePhoto_decorators = [Remote('savePhoto')];
+            _recordPage_decorators = [Remote('recordPage')];
+            _listCards_decorators = [Remote('listCards')];
+            _dueCards_decorators = [Remote('dueCards')];
+            _writeCards_decorators = [Remote('writeCards')];
+            _editCard_decorators = [Remote('editCard')];
+            _undoCards_decorators = [Remote('undoCards')];
+            _reviewCard_decorators = [Remote('reviewCard')];
+            _listAssessments_decorators = [Remote('listAssessments')];
+            _getAssessment_decorators = [Remote('getAssessment')];
+            _putAttempt_decorators = [Remote('putAttempt')];
+            _listAttempts_decorators = [Remote('listAttempts')];
+            _boundTarget_decorators = [Remote('boundTarget')];
+            _bindTarget_decorators = [Remote('bindTarget')];
+            _listEvents_decorators = [Remote('listEvents')];
+            _recentChanges_decorators = [Remote('recentChanges')];
+            _createRetake_decorators = [Remote('createRetake')];
+            _recentRecords_decorators = [Remote('recentRecords')];
+            _latestActivity_decorators = [Remote('latestActivity')];
+            _stats_decorators = [Remote('stats')];
+            __esDecorate(this, null, _capabilities_decorators, { kind: "method", name: "capabilities", static: false, private: false, access: { has: obj => "capabilities" in obj, get: obj => obj.capabilities }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listProjects_decorators, { kind: "method", name: "listProjects", static: false, private: false, access: { has: obj => "listProjects" in obj, get: obj => obj.listProjects }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getProject_decorators, { kind: "method", name: "getProject", static: false, private: false, access: { has: obj => "getProject" in obj, get: obj => obj.getProject }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _createProject_decorators, { kind: "method", name: "createProject", static: false, private: false, access: { has: obj => "createProject" in obj, get: obj => obj.createProject }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _updateProject_decorators, { kind: "method", name: "updateProject", static: false, private: false, access: { has: obj => "updateProject" in obj, get: obj => obj.updateProject }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _deleteProject_decorators, { kind: "method", name: "deleteProject", static: false, private: false, access: { has: obj => "deleteProject" in obj, get: obj => obj.deleteProject }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getResource_decorators, { kind: "method", name: "getResource", static: false, private: false, access: { has: obj => "getResource" in obj, get: obj => obj.getResource }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listResources_decorators, { kind: "method", name: "listResources", static: false, private: false, access: { has: obj => "listResources" in obj, get: obj => obj.listResources }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _putResource_decorators, { kind: "method", name: "putResource", static: false, private: false, access: { has: obj => "putResource" in obj, get: obj => obj.putResource }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _setBookKind_decorators, { kind: "method", name: "setBookKind", static: false, private: false, access: { has: obj => "setBookKind" in obj, get: obj => obj.setBookKind }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _moveResource_decorators, { kind: "method", name: "moveResource", static: false, private: false, access: { has: obj => "moveResource" in obj, get: obj => obj.moveResource }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _removeResource_decorators, { kind: "method", name: "removeResource", static: false, private: false, access: { has: obj => "removeResource" in obj, get: obj => obj.removeResource }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getRoadmap_decorators, { kind: "method", name: "getRoadmap", static: false, private: false, access: { has: obj => "getRoadmap" in obj, get: obj => obj.getRoadmap }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _adoptRoadmap_decorators, { kind: "method", name: "adoptRoadmap", static: false, private: false, access: { has: obj => "adoptRoadmap" in obj, get: obj => obj.adoptRoadmap }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _discardDraft_decorators, { kind: "method", name: "discardDraft", static: false, private: false, access: { has: obj => "discardDraft" in obj, get: obj => obj.discardDraft }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _markNodeRead_decorators, { kind: "method", name: "markNodeRead", static: false, private: false, access: { has: obj => "markNodeRead" in obj, get: obj => obj.markNodeRead }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listPages_decorators, { kind: "method", name: "listPages", static: false, private: false, access: { has: obj => "listPages" in obj, get: obj => obj.listPages }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _readPagePhoto_decorators, { kind: "method", name: "readPagePhoto", static: false, private: false, access: { has: obj => "readPagePhoto" in obj, get: obj => obj.readPagePhoto }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _savePhoto_decorators, { kind: "method", name: "savePhoto", static: false, private: false, access: { has: obj => "savePhoto" in obj, get: obj => obj.savePhoto }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _recordPage_decorators, { kind: "method", name: "recordPage", static: false, private: false, access: { has: obj => "recordPage" in obj, get: obj => obj.recordPage }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listCards_decorators, { kind: "method", name: "listCards", static: false, private: false, access: { has: obj => "listCards" in obj, get: obj => obj.listCards }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _dueCards_decorators, { kind: "method", name: "dueCards", static: false, private: false, access: { has: obj => "dueCards" in obj, get: obj => obj.dueCards }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _writeCards_decorators, { kind: "method", name: "writeCards", static: false, private: false, access: { has: obj => "writeCards" in obj, get: obj => obj.writeCards }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _editCard_decorators, { kind: "method", name: "editCard", static: false, private: false, access: { has: obj => "editCard" in obj, get: obj => obj.editCard }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _undoCards_decorators, { kind: "method", name: "undoCards", static: false, private: false, access: { has: obj => "undoCards" in obj, get: obj => obj.undoCards }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _reviewCard_decorators, { kind: "method", name: "reviewCard", static: false, private: false, access: { has: obj => "reviewCard" in obj, get: obj => obj.reviewCard }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listAssessments_decorators, { kind: "method", name: "listAssessments", static: false, private: false, access: { has: obj => "listAssessments" in obj, get: obj => obj.listAssessments }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _getAssessment_decorators, { kind: "method", name: "getAssessment", static: false, private: false, access: { has: obj => "getAssessment" in obj, get: obj => obj.getAssessment }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _putAttempt_decorators, { kind: "method", name: "putAttempt", static: false, private: false, access: { has: obj => "putAttempt" in obj, get: obj => obj.putAttempt }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listAttempts_decorators, { kind: "method", name: "listAttempts", static: false, private: false, access: { has: obj => "listAttempts" in obj, get: obj => obj.listAttempts }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _boundTarget_decorators, { kind: "method", name: "boundTarget", static: false, private: false, access: { has: obj => "boundTarget" in obj, get: obj => obj.boundTarget }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _bindTarget_decorators, { kind: "method", name: "bindTarget", static: false, private: false, access: { has: obj => "bindTarget" in obj, get: obj => obj.bindTarget }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _listEvents_decorators, { kind: "method", name: "listEvents", static: false, private: false, access: { has: obj => "listEvents" in obj, get: obj => obj.listEvents }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _recentChanges_decorators, { kind: "method", name: "recentChanges", static: false, private: false, access: { has: obj => "recentChanges" in obj, get: obj => obj.recentChanges }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _createRetake_decorators, { kind: "method", name: "createRetake", static: false, private: false, access: { has: obj => "createRetake" in obj, get: obj => obj.createRetake }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _recentRecords_decorators, { kind: "method", name: "recentRecords", static: false, private: false, access: { has: obj => "recentRecords" in obj, get: obj => obj.recentRecords }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _latestActivity_decorators, { kind: "method", name: "latestActivity", static: false, private: false, access: { has: obj => "latestActivity" in obj, get: obj => obj.latestActivity }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _stats_decorators, { kind: "method", name: "stats", static: false, private: false, access: { has: obj => "stats" in obj, get: obj => obj.stats }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static inject = ['library'];
+        constructor(ctx, _config = {}) {
+            super(ctx, 'libraryRemote', { namespace: 'library' });
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+        /** The service core this face delegates to. */
+        get core() {
+            return this.ctx.library;
+        }
+        /* -------------------------------------------------------- capabilities */
+        /** What this composition can do: storage and attachments, with the reason — the display contract. */
+        capabilities() {
+            return this.core.capabilities();
+        }
+        /* ------------------------------------------------------------ projects */
+        /** Every project with its shelf progress and card tallies. */
+        listProjects() {
+            return this.core.listProjects();
+        }
+        /** One project's summary plus its resources. */
+        getProject(request) {
+            return this.core.getProject(request);
+        }
+        /** Create a project. */
+        createProject(request) {
+            return this.core.createProject(request);
+        }
+        /** Change a project's look, goal or name. */
+        updateProject(request) {
+            return this.core.updateProject(request);
+        }
+        /** Delete a project and everything it holds. */
+        deleteProject(request) {
+            return this.core.deleteProject(request);
+        }
+        /* ------------------------------------------------------------ resources */
+        /** One shelf entry, whole. */
+        getResource(request) {
+            return this.core.getResource(request);
+        }
+        /** A project's shelf: textbooks in study order, then links oldest first. */
+        listResources(request) {
+            return this.core.listResources(request);
+        }
+        /** Put one entry on the shelf (a thin link from the sidebar's add form). */
+        putResource(request) {
+            return this.core.putResource(request);
+        }
+        /** Switch a textbook between 知识型 and 材料型. */
+        setBookKind(request) {
+            return this.core.setBookKind(request);
+        }
+        /** Move a textbook to another place in the study order. */
+        moveResource(request) {
+            return this.core.moveResource(request);
+        }
+        /** Remove a shelf entry (its cards stay, unhung). */
+        removeResource(request) {
+            return this.core.removeResource(request);
+        }
+        /* ------------------------------------------------------------- roadmap */
+        /** One textbook's adopted roadmap and its pending draft. */
+        getRoadmap(request) {
+            return this.core.getRoadmap(request);
+        }
+        /** The learner's 采用. */
+        adoptRoadmap(request) {
+            return this.core.adoptRoadmap(request);
+        }
+        /** Drop a draft. */
+        discardDraft(request) {
+            return this.core.discardDraft(request);
+        }
+        /** 「读完」 a read node. */
+        markNodeRead(request) {
+            return this.core.markNodeRead(request);
+        }
+        /* --------------------------------------------------------------- pages */
+        /** One resource's pages, optionally one node's. */
+        listPages(request) {
+            return this.core.listPages(request);
+        }
+        /** One page's photo, base64 — whitelisted to recorded pages. */
+        readPagePhoto(request) {
+            return this.core.readPagePhoto(request);
+        }
+        /** Save a browser-uploaded photo into the attachment store. */
+        savePhoto(request) {
+            return this.core.savePhoto(request);
+        }
+        /** Record a recognized page and card its marks. */
+        recordPage(request) {
+            return this.core.recordPage(request);
+        }
+        /* --------------------------------------------------------------- cards */
+        /** Cards, filtered and sorted. */
+        listCards(request) {
+            return this.core.listCards(request);
+        }
+        /** Due cards across projects (or one). */
+        dueCards(request) {
+            return this.core.dueCards(request);
+        }
+        /** Record cards by hand. */
+        writeCards(request) {
+            return this.core.writeCards(request);
+        }
+        /** Edit one card. */
+        editCard(request) {
+            return this.core.editCard(request);
+        }
+        /** The toast's 撤销. */
+        undoCards(request) {
+            return this.core.undoCards(request);
+        }
+        /** One flashcard review. */
+        reviewCard(request) {
+            return this.core.reviewCard(request);
+        }
+        /* ---------------------------------------------------------- assessments */
+        /** A project's assessments, optionally one resource's / node's / one type's. */
+        listAssessments(request) {
+            return this.core.listAssessments(request);
+        }
+        /** One assessment, whole. */
+        getAssessment(request) {
+            return this.core.getAssessment(request);
+        }
+        /** Grade a sitting answered in the sidebar (choice / fill judged in the page). */
+        putAttempt(request) {
+            return this.core.putAttempt(request);
+        }
+        /** A project's graded sittings, newest first; `nodeId` narrows to one station's history, `assessmentId` to one assessment's. */
+        listAttempts(request) {
+            return this.core.listAttempts(request);
+        }
+        /* ------------------------------------------------------------- bindings */
+        /** The calling session's binding, or null. */
+        async boundTarget(sessionId) {
+            return this.core.getBinding(String(sessionId)) ?? null;
+        }
+        /** Bind the calling session to a project / resource (null unbinds). */
+        bindTarget(sessionId, request) {
+            return this.core.setBinding(String(sessionId), request.binding);
+        }
+        /* --------------------------------------------------------------- events */
+        /** One project's audit trail, newest first. */
+        listEvents(request) {
+            return this.core.listEvents(request);
+        }
+        /** 「教练最近记下」 across projects. */
+        /** The newest knowledge-point state changes (今日 「最近的变化」). */
+        recentChanges(request) {
+            return this.core.recentChanges(request);
+        }
+        /** 订正: a retake paper over a station's open misses (all, or the keys named). */
+        createRetake(request) {
+            return this.core.createRetake(request);
+        }
+        recentRecords(request) {
+            return this.core.recentRecords(request);
+        }
+        /** The newest event's timestamp anywhere — the pane polls it to re-read (no push channel). */
+        latestActivity() {
+            return this.core.latestActivity();
+        }
+        /** The whole-library tally. */
+        stats() {
+            return this.core.stats();
+        }
+    };
+})();
+export { LibraryRemoteService };
+export default LibraryRemoteService;

package/lib/types/service/assess.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Assessments and attempts: quizzes (the two-axis checks), the assess cascade, acceptance sittings.
+ *
+ * One layer of the library service (see `service/core.ts` for the layering):
+ * the methods are the service's own, moved here verbatim by domain.
+ *
+ * @module @khorsheed/dsh-library/service/assess
+ */
+import { type LibraryAssessResult, type LibraryPointChange, type LibraryAssessment, type LibraryAttempt, type LibraryCard, type LibraryOutcome, type LibraryProject, type LibraryQuizFocus, type LibraryQuizQuestion, type LibraryPoint, type LibraryRoadmap, type LibraryTemplate, type LibraryVerdict } from '../types.ts';
+import { type LibraryOpenMiss, type LibraryPointMastery, type LibraryStationMastery } from '../mastery.ts';
+import { LibraryServicePages } from './pages.ts';
+export declare class LibraryServiceAssess extends LibraryServicePages {
+    /** A project's assessments, optionally one resource's / node's / one type's. */
+    listAssessments(request: {
+        projectId: string;
+        resourceId?: string;
+        nodeId?: string;
+        type?: 'quiz' | 'practice';
+    }): Promise<{
+        assessments: LibraryAssessment[];
+    }>;
+    /** One assessment, whole. */
+    getAssessment(request: {
+        projectId: string;
+        assessmentId: string;
+    }): Promise<LibraryOutcome<{
+        assessment: LibraryAssessment;
+    }>>;
+    /**
+     * Store a quiz behind the two-axis checks. Target: a marked / asked / missed
+     * question names the live cards it probes. Evidence: a photo quote names a
+     * recorded page (a quote the page text lacks comes back as a warning); a web
+     * quote carries its url; whether domain knowledge may back a CONTENT question
+     * is judged on the gated node's covers (a material book, a thin link or a
+     * bare url among them demands a verbatim quote) — a resource-scoped quiz
+     * without a node keeps the resource-level rule, and a scopeless free quiz
+     * allows knowledge. A node-scoped quiz supersedes the station's live one.
+     */
+    putQuiz(request: {
+        projectId: string;
+        quiz: {
+            scope: {
+                resourceId?: string;
+                nodeId?: string;
+            };
+            focus?: LibraryQuizFocus;
+            questions: readonly LibraryQuizQuestion[];
+            /** Append knowledge points to the gated station (a genuine gap in the split) — ids must be new; an existing id is referenced, never re-added. */
+            addPoints?: readonly LibraryPoint[];
+        };
+    }): Promise<LibraryOutcome<{
+        quiz: LibraryAssessment;
+        warnings: string[];
+    }>>;
+    /**
+     * Grade a sitting — the only cascading write. Two shapes, exactly one key:
+     * `assessmentId` (or the legacy alias `quizId`) judges a stored quiz;
+     * `nodeId` accepts an ACCEPTANCE station — resolved to the node's current
+     * practice assessment, each verdict's task naming one rubric line (its id
+     * L1…, or the line verbatim).
+     *
+     * Void verdicts count for nothing. Every probed card moves: a pass climbs a
+     * Leitner box and eases weakness by one; a fail resets to box 0 (due
+     * tomorrow) and adds weakness. A failed line with no card gets one
+     * (`missedCard`). The gated node's stats update (quiz nodes); at or above
+     * the pass ratio it completes and unlocks its dependents.
+     */
+    putAttempt(request: {
+        projectId: string;
+        assessmentId?: string;
+        quizId?: string;
+        nodeId?: string;
+        /** The textbook whose path the acceptance station sits on (omitted: the textbook whose path holds the node). */
+        resourceId?: string;
+        verdicts: readonly LibraryVerdict[];
+    }): Promise<LibraryOutcome<LibraryAssessResult>>;
+    /** The quiz path of putAttempt: verdicts judged against a stored quiz's questions. */
+    protected putQuizAttempt(project: LibraryProject, assessmentId: string, verdicts: readonly LibraryVerdict[]): Promise<LibraryOutcome<LibraryAssessResult>>;
+    /**
+     * The practice path of putAttempt: acceptance of a hands-on station, judged
+     * against the node's current practice assessment (materialized at adoption).
+     * No probed cards — a failed acceptance line with a `missedCard` leaves (or
+     * re-weakens) a card; at the pass ratio the station completes.
+     */
+    protected putPracticeAttempt(project: LibraryProject, nodeId: string, resourceId: string | undefined, verdicts: readonly LibraryVerdict[]): Promise<LibraryOutcome<LibraryAssessResult>>;
+    /** Every open miss across the project's adopted quiz stations, newest first. */
+    protected projectOpenMisses(projectId: string): LibraryOpenMiss[];
+    /** A station's mastery as the ledger stands (undefined off a station, or for a node no adopted path holds). */
+    protected stationMasteryOf(projectId: string, nodeId: string | undefined, resourceId?: string): LibraryStationMastery | undefined;
+    /**
+     * The points a write moved, read against `before`; each change is ledgered
+     * as a `point.changed` event (今日 「最近的变化」). Call inside the lock,
+     * after the write.
+     */
+    protected pointChangesSince(projectId: string, nodeId: string | undefined, resourceId: string | undefined, before: LibraryStationMastery | undefined, at: string): LibraryPointChange[];
+    /**
+     * 订正: a retake paper re-asking a station's open misses (all, or the keys
+     * named — `${assessmentId}:${questionId}`). Its verdicts move the points,
+     * never the station's pass record. No coach needed: the questions exist.
+     */
+    createRetake(request: {
+        projectId: string;
+        resourceId?: string;
+        nodeId?: string;
+        keys?: readonly string[];
+    }): Promise<LibraryOutcome<{
+        assessment: LibraryAssessment;
+    }>>;
+    /**
+     * A coach note on a knowledge point: the learner stuck on it here. The
+     * point turns weak until a newer probe passes (subject projects — a weak
+     * point lands on its point, not on a card).
+     */
+    notePoint(request: {
+        projectId: string;
+        resourceId?: string;
+        nodeId: string;
+        pointId: string;
+        text: string;
+        term?: string;
+        session?: string;
+    }): Promise<LibraryOutcome<{
+        point: LibraryPointMastery;
+        changes: LibraryPointChange[];
+    }>>;
+    /** The roadmap holding one node: the hinted textbook's first, then every adopted path of the project. */
+    protected findNodeRoadmap(projectId: string, nodeId: string, resourceId?: string): LibraryRoadmap | undefined;
+    /** The card a missed, card-less question leaves behind. */
+    protected missedCardFor(question: LibraryQuizQuestion, verdict: LibraryVerdict, quiz: LibraryAssessment, resourceId: string | undefined, template: LibraryTemplate, at: string): LibraryCard;
+    /**
+     * A project's graded sittings, newest first. `nodeId` narrows to one node's
+     * history: sittings keyed to an assessment scoped on it, plus legacy v4
+     * acceptance sittings that named the node directly. `assessmentId` narrows
+     * to one assessment's sittings.
+     */
+    listAttempts(request: {
+        projectId: string;
+        nodeId?: string;
+        assessmentId?: string;
+    }): Promise<{
+        attempts: LibraryAttempt[];
+    }>;
+}
+//# sourceMappingURL=assess.d.ts.map