@sparkelf/dsh-knowledge-base 0.1.30 → 0.1.31

package/lib/index.js

@@ -11798,6 +11798,7 @@ function permissionForKbRoute(method) {
 	if (method === "create" || method === "edit" || method === "move" || method === "upload" || method === "rename") return "kb:file:write";
 	if (method === "trash" || method === "trash.remove" || method === "trash.restore") return "kb:file:delete";
 	if (method === "index" || method === "extract.retry") return "kb:file:extract";
+	if (method === "index.status") return "kb:file:read";
 	if (method === "audit.list") return "kb:audit:read";
 	if (method === "grants" || method === "grant" || method === "revoke") return "kb:grant:manage";
 	if (method === "pending.list" || method === "pending.approve" || method === "pending.reject") return "kb:review:decide";
@@ -13399,6 +13400,32 @@ function apply(ctx, deploymentConfig) {
 						});
 					}
 					case "extract.status": return writeJson(res, 200, extractionQueue.snapshot());
+					case "index.status": {
+						const body = await readJsonBody(req);
+						const relPath = typeof body.path === "string" ? body.path.trim() : "";
+						const docId = Number(body.docId);
+						const db = new DatabaseSync(indexPathFor(config.indexDir));
+						try {
+							let row;
+							if (Number.isInteger(docId) && docId > 0) row = db.prepare("select id, path, scope, mtime from kb_docs where id = ?").get(docId);
+							else if (relPath !== "") {
+								const name = relPath.slice(relPath.lastIndexOf("/") + 1);
+								row = db.prepare("select id, path, scope, mtime from kb_docs where path = ?").get(relPath) ?? db.prepare("select id, path, scope, mtime from kb_docs where path = ? order by mtime desc limit 1").get(name) ?? db.prepare("select id, path, scope, mtime from kb_docs where path like ? order by mtime desc limit 1").get("%/" + relPath) ?? db.prepare("select id, path, scope, mtime from kb_docs where path like ? order by mtime desc limit 1").get("%" + relPath) ?? db.prepare("select id, path, scope, mtime from kb_docs where path like ? order by mtime desc limit 1").get("%/" + name);
+							}
+							if (row === void 0) return writeJson(res, 200, { found: false });
+							const count = db.prepare("select count(*) as n from kb_chunks where doc_id = ?").get(row.id);
+							return writeJson(res, 200, {
+								found: true,
+								docId: row.id,
+								path: row.path,
+								scope: row.scope,
+								chunks: Number(count?.n ?? 0),
+								indexedAt: row.mtime
+							});
+						} finally {
+							db.close();
+						}
+					}
 					case "extract.retry": {
 						const body = await readJsonBody(req);
 						const relPath = String(body.relPath ?? "");
@@ -13413,32 +13440,33 @@ function apply(ctx, deploymentConfig) {
 							error: "path escapes the knowledge root",
 							refused: [relPath]
 						});
-						if (isAlreadyMarkdown(relPath)) {
-							extractionQueue.enqueue(relPath, "");
+						const actualRelPath = await actualRelPathForView(host, config, relPath).catch(() => relPath);
+						if (isAlreadyMarkdown(actualRelPath)) {
+							extractionQueue.enqueue(actualRelPath, "");
 							return writeJson(res, 200, {
 								outcome: "already-markdown",
-								relPath,
+								relPath: actualRelPath,
 								message: "this document is already Markdown"
 							});
 						}
-						if (!isExtractable(relPath)) return writeJson(res, 200, {
+						if (!isExtractable(actualRelPath)) return writeJson(res, 200, {
 							outcome: "unsupported",
-							relPath,
+							relPath: actualRelPath,
 							message: "this file type has no extractor"
 						});
 						const localRoot = localConfig(config);
-						const target = join(localRoot.actualRoot, relPath);
+						const target = join(localRoot.actualRoot, actualRelPath);
 						const source = await stat(target).catch(() => void 0);
 						if (source === void 0 || !source.isFile()) return writeJson(res, 404, { error: "no such file" });
-						if (!await canWritePath(host, config, relPath)) return writeJson(res, 403, {
+						if (!await canWritePath(host, config, actualRelPath)) return writeJson(res, 403, {
 							error: "write access is required to extract here",
 							refused: [relPath]
 						});
-						const sibling = markdownSiblingOf(relPath);
+						const sibling = markdownSiblingOf(actualRelPath);
 						const existing = await stat(join(localRoot.actualRoot, sibling)).catch(() => void 0);
 						if (existing !== void 0 && existing.isFile()) return writeJson(res, 200, {
 							outcome: "exists",
-							relPath,
+							relPath: actualRelPath,
 							markdown: sibling
 						});
 						const settings = await readSettings(viewPathFor({
@@ -13446,13 +13474,13 @@ function apply(ctx, deploymentConfig) {
 							viewRoot: localRoot.viewRoot,
 							userId: (await fetchCaller(host, config).catch(() => void 0))?.userId ?? ""
 						}));
-						const accepted = extractionQueue.enqueue(relPath, settings.mineruBaseUrl);
+						const accepted = extractionQueue.enqueue(actualRelPath, settings.mineruBaseUrl);
 						if (body.wait === false) return writeJson(res, 202, {
 							outcome: "queued",
-							relPath,
+							relPath: actualRelPath,
 							extraction: accepted
 						});
-						const settled = await extractionQueue.settled(relPath);
+						const settled = await extractionQueue.settled(actualRelPath);
 						const outcome = settled === void 0 ? {
 							state: "failed",
 							reason: "the extraction task was not recorded"

package/lib/types/api.d.ts

@@ -138,6 +138,7 @@ export declare const KB_API: {
     readonly extractStatus: "extract.status";
     /** Re-run extraction for one document that could not finish. */
     readonly extractRetry: "extract.retry";
+    readonly indexStatus: "index.status";
     /** Read the caller's pinned paths. */
     readonly favoritesGet: "favorites.get";
     readonly favoritesSet: "favorites.set";

package/lib/types/client/KnowledgeHome.d.ts

@@ -25,6 +25,8 @@ interface HomeRow {
     location: string;
     /** Last-modified instant in Unix ms, which is the tree's only timestamp. */
     mtimeMs?: number;
+    /** Host's answer: a `.md` sibling exists beside this non-text document. */
+    hasMarkdown?: boolean;
 }
 /** Props for the Home surface. */
 export interface KnowledgeHomeProps {

package/lib/types/client/KnowledgeProgressPopover.d.ts

@@ -60,10 +60,18 @@ export interface KnowledgeProgressPopoverProps {
      * exists to remove. The page owns the store; this component only draws it.
      */
     failures?: readonly FailedExtractionView[];
+    /**
+     * Keep the persistence/polling work but render no bell or modal.
+     *
+     * The queue now lives in the Task Center's notifications tab, which reads the same
+     * localStorage key; the Knowledge page only needs this component mounted to keep
+     * writing observations.
+     */
+    headless?: boolean;
 }
 /**
  * The notification button and its progress panel.
  * @param props - the upload batch, whether to watch extraction, and the copy resolver.
  * @returns The button, plus the panel while it is open.
  */
-export declare function KnowledgeProgressPopover(props: KnowledgeProgressPopoverProps): import("react").JSX.Element;
+export declare function KnowledgeProgressPopover(props: KnowledgeProgressPopoverProps): import("react").JSX.Element | null;

package/lib/types/client/locales.d.ts

@@ -55,7 +55,6 @@ export declare const en: {
     readonly renameFailed: "Could not rename: the file may already exist or you may not have write access.";
     readonly downloadFailed: "Could not download this file.";
     readonly 'menu.home': "Home";
-    readonly 'menu.permissions': "Permissions";
     readonly 'menu.indexing': "Directories & counts";
     readonly 'menu.trash': "Trash";
     readonly brand: "Wanxiang Knowledge";
@@ -115,6 +114,24 @@ export declare const en: {
     readonly homeColOwnerUnset: "Not recorded";
     readonly homeColCreated: "Created";
     readonly homeColOpened: "Last opened";
+    readonly homeColStatus: "Status";
+    readonly homeStatusExtracted: "Extracted";
+    readonly homeStatusNotExtracted: "Not extracted";
+    readonly homeStatusIndexed: "Indexed";
+    readonly homeStatusNotIndexed: "Not indexed";
+    readonly statusFileName: "File";
+    readonly statusPath: "Path";
+    readonly statusType: "Type";
+    readonly statusTypeText: "Text";
+    readonly statusTypeNonText: "Document";
+    readonly statusExtract: "Extraction";
+    readonly statusExtractTime: "Extracted at";
+    readonly statusMdSize: ".md size";
+    readonly statusIndex: "Index";
+    readonly statusIndexTime: "Indexed at";
+    readonly statusChunks: "Chunks / docId";
+    readonly statusFailure: "Failure reason";
+    readonly statusClose: "Close";
     readonly homeEmpty: "Nothing here yet.";
     readonly trashEmpty: "Trash is empty";
     readonly trashPending: "Deleting a document is not enabled yet. The knowledge tree is shared, and how long a deletion is kept is still being decided.";
@@ -325,6 +342,10 @@ export declare const en: {
     readonly auditActionUpload: "Upload";
     readonly auditActionMove: "Move";
     readonly auditActionEdit: "Edit";
+    readonly auditActionDelete: "Delete";
+    readonly auditActionExternalChange: "External change";
+    readonly auditActorExternalChange: "External process";
+    readonly auditActorSystem: "System";
     readonly auditOutcomeApplied: "Applied";
     readonly auditOutcomePending: "Pending review";
     readonly storageProtocol: "Protocol";
@@ -373,6 +394,7 @@ export declare const en: {
     readonly progressBadgeMore: "99+";
     readonly progressOpen: "Upload and extraction progress";
     readonly progressClose: "Close";
+    readonly progressClear: "Clear history";
     readonly dropRefusedNoCaller: "Cannot place this upload";
     readonly dropRefusedNoCallerReason: "The host has not reported your account yet, so the personal folder cannot be resolved. Reload and try again.";
     readonly progressResize: "Drag to resize";
@@ -466,7 +488,14 @@ export declare const en: {
     readonly refPickerBatchTitle: "Reference {n} items in a chat";
     readonly refPickerFailed: "Could not insert the reference into that chat.";
     readonly dropHomeHint: "Drop to upload into your personal folder";
-    readonly progressTitle: "Progress";
+    readonly progressTitle: "Task queue";
+    readonly progressQueueTitle: "Tasks";
+    readonly progressUploadDone: "Uploaded";
+    readonly progressExtractDone: "Extraction done";
+    readonly progressStepUploading: "Uploading";
+    readonly progressStepUploaded: "Uploaded";
+    readonly progressStepExtracting: "Extracting";
+    readonly progressStepExtracted: "Extracted";
     readonly progressRoot: "Root";
     readonly overviewByRole: "By role";
     readonly sourceDirect: "Direct";
@@ -496,7 +525,7 @@ export declare const en: {
     readonly progressExtractGroup: "Extractions";
     readonly progressUploading: "Uploading {done}/{total}";
     readonly progressPending: "Queued";
-    readonly progressExtracting: "Extracting";
+    readonly progressExtracting: "Extracting…";
     readonly progressStepParse: "Parsing document";
     readonly progressStepChunk: "Chunking text";
     readonly progressStepIndex: "Writing FTS5 index";

package/lib/types/client/progressRules.d.ts

@@ -87,6 +87,10 @@ export interface UploadTaskView {
     state: 'waiting' | 'uploading' | 'done' | 'failed';
     /** Why it failed, in the Host's own words. */
     reason?: string;
+    /**
+     * When this row was enqueued, ISO-8601. Used to order the unified task queue.
+     */
+    at?: string;
     /**
      * Bytes sent, as 0-100.
      *
@@ -112,9 +116,12 @@ export interface UploadTaskView {
  */
 export declare function pendingCount(uploads: readonly {
     state: string;
+    at?: string;
 }[], extractions: readonly {
     state: string;
 }[]): number;
+/** 上传完成后继续轮询提取任务的窗口。 */
+export declare const UPLOAD_EXTRACTION_GRACE_MS = 30000;
 /**
  * How long an optimistic extraction entry may wait for the Host to confirm it.
  *

package/lib/types/client/taskQueueStore.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Local persistence for the task queue.
+ *
+ * Only metadata is stored: a reader who comes back after a reload should still see what
+ * they uploaded or extracted, not the document bytes. Records older than the retention
+ * window are dropped on load, and the list is capped so a long-lived profile cannot grow
+ * without bound.
+ *
+ * @module @sparkelf/dsh-knowledge-base/client
+ */
+/** One task as it is remembered across reloads. */
+export interface PersistedTask {
+    /** Stable queue id (`upload:<path>` / `extract:<path>`). */
+    id: string;
+    /** Display name of the source document. */
+    fileName: string;
+    /** Which operation the task represents. */
+    kind: 'upload' | 'extract';
+    /** Last observed lifecycle state. */
+    stage: 'uploading' | 'uploaded' | 'extracting' | 'done' | 'failed';
+    /** Upload percentage, 0-100, when known. */
+    progress?: number;
+    /** When the task was first seen, epoch milliseconds. */
+    startedAt: number;
+    /** When it reached a terminal state, epoch milliseconds. */
+    finishedAt?: number;
+    /** Failure reason, when the task failed. */
+    error?: string;
+}
+/** The localStorage key this plugin owns. */
+export declare const TASK_QUEUE_STORAGE_KEY = "dataops-kb-task-queue-v1";
+/** How long a record is kept. */
+export declare const TASK_QUEUE_RETENTION_MS: number;
+/** Upper bound on records, newest first. */
+export declare const TASK_QUEUE_MAX_RECORDS = 200;
+/**
+ * Read the retained queue.
+ * @param now - current epoch milliseconds, injectable for tests.
+ * @returns Newest-first records inside the retention window.
+ */
+export declare function loadTaskQueue(now?: number): PersistedTask[];
+/**
+ * Persist the queue, silently degrading when storage is unavailable.
+ * @param records - the records to write, already ordered.
+ */
+export declare function saveTaskQueue(records: readonly PersistedTask[]): void;
+/**
+ * Merge freshly observed rows into the stored history.
+ *
+ * A new observation wins for the mutable fields (stage/progress/error), while the first
+ * `startedAt` and the first terminal `finishedAt` are preserved so a task does not appear
+ * to restart on every poll.
+ * @param current - stored records.
+ * @param incoming - rows observed this render.
+ * @param now - current epoch milliseconds.
+ * @returns Newest-first merged records, capped.
+ */
+export declare function mergeTaskRecords(current: readonly PersistedTask[], incoming: readonly PersistedTask[], now?: number): PersistedTask[];
+/** Remove every stored record. */
+export declare function clearTaskQueue(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkelf/dsh-knowledge-base",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "DataOps-backed knowledge base for DeepSeek Harness: a left-sidebar destination, Settings configuration, and index tooling over a mounted NAS view.",
   "type": "module",
   "main": "./lib/index.js",
@@ -43,7 +43,7 @@
     "README.md",
     "LICENSE",
     "SKILL.md",
-    "万相AI使用教程.html",
+    "\u4e07\u76f8AI\u4f7f\u7528\u6559\u7a0b.html",
     "i18n/*.json",
     "skills/**/SKILL.md",
     "skills/**/i18n/*.json"

package/lib/types/client/KnowledgePermissionOverview.d.ts

@@ -1,143 +0,0 @@
-/**
- * The permissions surface: one grant table, read two ways.
- *
- * A grant says "this principal may do this action to this path". That is the right
- * shape to STORE and the wrong shape to AUDIT: an administrator asking "what does
- * 张三 have" and "who can see 制度.md" is asking two questions that one
- * row-per-grant layout cannot answer without being read line by line.
- *
- * So the page has one body and two readings of it. The tabs switch which question
- * is being asked; both render the same loaded grants, so the two can never
- * disagree. No second endpoint exists because there is no second truth.
- *
- * The tables are the page's own body rather than a summary above one. An earlier
- * version stacked both readings as bulleted lists and *also* drew a third,
- * row-per-principal table underneath: three renderings of one payload, so the
- * reader had to work out which of the three was authoritative before reading any
- * of them. Two tabs over one table removes that question.
- *
- * @module @sparkelf/dsh-knowledge-base/client/KnowledgePermissionOverview
- */
-import type { GrantView, KnowledgeGrantSubjectType } from '../api.ts';
-/** Which reading of the grant table the tabs are showing. */
-export type OverviewTab = 'person' | 'role' | 'resource';
-/** Copy for the overview, supplied by the caller's locale record. */
-export interface OverviewCopy {
-    tabByPerson: string;
-    tabByRole: string;
-    tabByResource: string;
-    empty: string;
-    /** Empty state per view, so "nobody is directly granted" is not shown for a role. */
-    emptyByPerson: string;
-    emptyByRole: string;
-    emptyByResource: string;
-    /** Where a principal's access comes from. */
-    sourceDirect: string;
-    /** Format "inherited via role X": `{role}` is replaced by the role code. */
-    sourceViaRole: (role: string) => string;
-    /** Shown when the user directory could not be read, so inheritance is unknowable. */
-    sourceUnavailable: string;
-    /** Word for a permission set that could not be fully determined. */
-    actionsUnknown: string;
-    actionsUnknownHint: string;
-    /** Column headers unique to the three views. */
-    colAccount: string;
-    colSource: string;
-    /** "{count} member(s)". */
-    roleMemberCount: (count: number) => string;
-    /** Pager copy, shared with the audit table's wording. */
-    pagerPrev: string;
-    pagerNext: string;
-    pagerStatus: (page: number, pageCount: number, total: number) => string;
-    pageSizeLabel: string;
-    pageSizeOption: (size: number) => string;
-    pathsHeld: (count: number) => string;
-    rolesHeld: string;
-    actionsHeld: string;
-    noActions: string;
-    /** Accessible name for the tab strip, for readers who arrive at it by keyboard. */
-    tabsLabel: string;
-    /** Stat-card labels: the four numbers the page leads with. */
-    statPrincipals: string;
-    statResources: string;
-    statGrants: string;
-    statRoles: string;
-    /** Shared column headers, person reading. */
-    colPrincipal: string;
-    colKind: string;
-    colPermission: string;
-    colResources: string;
-    colExpiry: string;
-    colActions: string;
-    /** Shared column headers, resource reading. */
-    colResource: string;
-    colHolders: string;
-    colKindOfResource: string;
-    revoke: string;
-    revokeBusy: string;
-    expiryNever: string;
-    kindFile: string;
-    kindDirectory: string;
-    /** Formats "N grants · M paths" under a person's name. */
-    grantsUnit: (count: number) => string;
-    resourcesUnit: (count: number) => string;
-    /**
-     * Resolves a principal kind and an action to its localized word.
-     *
-     * Supplied as callbacks rather than as a keyed map so this component never
-     * reaches into the locale record itself: a caller with its own wording (a test,
-     * another surface) can pass its own, and the type checker still enforces that
-     * every kind and action the table can print has a word.
-     */
-    kindLabel: (kind: KnowledgeGrantSubjectType) => string;
-    actionLabel: (action: string) => string;
-}
-/** Props the parent panel supplies. */
-export interface KnowledgePermissionOverviewProps {
-    /** The grant table already loaded by the permissions page. */
-    grants: readonly GrantView[];
-    /** Display names by `principalType:principalId`. */
-    labels?: Readonly<Record<string, string>>;
-    /**
-     * The DataOps account directory, when the caller could read it.
-     *
-     * Absent means the same as an unavailable read: inheritance cannot be attributed, and
-     * the page says so instead of listing accounts that look like they hold nothing.
-     */
-    directory?: {
-        kind: 'available';
-        users: ReadonlyArray<{
-            id: string;
-            label: string;
-            username?: string;
-            roleCodes?: string[];
-        }>;
-    } | {
-        kind: 'unavailable';
-        reason: string;
-    };
-    /** Locale copy. */
-    copy: OverviewCopy;
-    /**
-     * Asks the parent to confirm revoking the grants one row covers.
-     *
-     * The confirmation lives in the parent because it is a dialog, and a dialog in
-     * the middle of a table's row renderer would make the table responsible for
-     * ownership of the overlay. This component says *what* to revoke; the parent
-     * decides whether to ask first and then performs it.
-     */
-    onRevoke: (grants: GrantView[], label: string) => void;
-    /** Disables every revoke control while a write is in flight. */
-    busy?: boolean;
-}
-/**
- * Render the permission overview as stat cards over a three-tab table.
- *
- * THREE views, not two, because the old pair answered different questions under one
- * heading: "by person" listed ROLE grants, so the only rows were 管理员 and 超级管理员
- * and a reader concluding "these are the people with access" was reading the page
- * correctly and being told something false. A role is not a person.
- *
- * @param props - grants, labels, directory, role summaries, copy and the revoke hook.
- */
-export declare function KnowledgePermissionOverview(props: KnowledgePermissionOverviewProps): import("react").JSX.Element;

package/lib/types/client/KnowledgePermissions.d.ts

@@ -1,47 +0,0 @@
-/**
- * The permissions surface of the management page.
- *
- * This view reads and writes grants through the DSH Host, which forwards them to
- * the DataOps backend. It deliberately holds no policy of its own: the backend's
- * authorization resolves the principal, checks the caller's permission keys, and
- * enforces what a grant means. The page only presents the result, so a rule
- * change lands in one place.
- *
- * The page leads with its table. A grant list is what an operator opens this
- * surface to read, so the data is the body of the page and the two things that
- * CHANGE it -- creating a grant, revoking one -- are raised into dialogs. A form
- * parked above the table would push the answer below the fold to make room for
- * the question.
- *
- * @module @sparkelf/dsh-knowledge-base/client
- */
-import { type ReactNode } from 'react';
-/** Props for the permissions surface. */
-export interface KnowledgePermissionsProps {
-    /**
-     * Publishes this page's primary control to the panel header.
-     *
-     * The header is the only band at the top of the page, so a page-level action has
-     * to be handed up rather than drawn in a second title row.
-     */
-    onAction?: (action: ReactNode) => void;
-    /** Locale-bound copy resolver. */
-    t: (key: string) => string;
-    /** Mount point the grants are scoped to. */
-    mountPoint: string;
-    /** Path the user selected, when the surface opened from a file row. */
-    initialPath?: string;
-    /**
-     * Changes when a row's context menu picks a new path.
-     *
-     * The form's path field is seeded from `initialPath` once; without a signal that
-     * the seed changed, a second right-click would leave the field on the first path.
-     */
-    reloadToken?: number;
-}
-/**
- * Render the permission editor.
- * @param props - copy resolver and the mount point grants are scoped to.
- * @returns The permission surface.
- */
-export declare function KnowledgePermissions(props: KnowledgePermissionsProps): import("react").JSX.Element;