oasis_test 0.1.128 → 0.1.129

package/dist/outline/outline-kb.mjs

@@ -23,6 +23,8 @@ const CONTENT_HASH_PENDING = "pending";
 const USAGE = "Usage: outline-kb <command> [arguments] [--collection ID] [--root ID]. Run outline-kb <command> --help for the exact contract.";
 const WRITE_COMMANDS = new Set(["init", "create", "update", "append", "import-file", "import-url", "import-wechat", "apply"]);
 const QUERY_COMMANDS = new Set(["status", "search", "read", "read-many", "search-and-read"]);
+const INGEST_FORBIDDEN_COMMANDS = new Set(["init", "create", "update", "append", "apply", "lint"]);
+const MAINTENANCE_ALLOWED_COMMANDS = new Set(["status", "validate-maintenance-plan"]);
 const WECHAT_ARTICLE_HOSTS = new Set(["mp.weixin.qq.com", "weixin.qq.com"]);
 const WECHAT_FETCH_HEADERS = Object.freeze({
   "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0 Safari/537.36",
@@ -57,6 +59,32 @@ const PLAN_EXAMPLE = {
     { type: "append", path: "log", contentFile: "log.md" },
   ],
 };
+const MAINTENANCE_PLAN_SCHEMA = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  type: "object",
+  required: ["jobId", "operations"],
+  additionalProperties: false,
+  properties: {
+    jobId: { type: "string", minLength: 1 },
+    sourceHash: { type: "string" },
+    operations: {
+      type: "array",
+      items: {
+        oneOf: [
+          { type: "object", required: ["type", "path", "contentFile"], properties: { type: { const: "create" }, path: { type: "string" }, contentFile: { type: "string" } }, additionalProperties: false },
+          { type: "object", required: ["type", "path", "contentFile"], properties: { type: { const: "update" }, path: { type: "string" }, contentFile: { type: "string" } }, additionalProperties: false },
+        ],
+      },
+    },
+  },
+};
+const MAINTENANCE_PLAN_EXAMPLE = {
+  jobId: "knowledge-maintenance-20260831-001",
+  operations: [
+    { type: "create", path: "wiki/concepts/example", contentFile: "concept.md" },
+    { type: "update", path: "wiki/synthesis/existing", contentFile: "synthesis.md" },
+  ],
+};
 const HELP_FAILURE_EXAMPLE = { ok: false, error: { code: "USAGE", message: "missing required argument" } };
 const PLAN_FAILURE_EXAMPLES = [
   { ok: false, error: { code: "PLAN_FILE_NOT_FOUND", message: "Plan file not found", details: { path: "/workspace/kb-plan/plan.json" } } },
@@ -79,6 +107,7 @@ const COMMAND_HELP = {
   "import-url": { usage: "outline-kb import-url URL --path raw/PATH --collection ID [--root ID]", description: "Fetch a public URL and import immutable raw evidence. WeChat article URLs are routed to the dedicated parser automatically." },
   "import-wechat": { usage: "outline-kb import-wechat WECHAT_URL --path raw/PATH --collection ID [--root ID]", description: "Capture a WeChat Official Account article with #js_content and publisher metadata validation." },
   "validate-plan": { usage: "outline-kb validate-plan PLAN.json --collection ID [--root ID]", description: "Validate local files, plan schema and every CAS precondition without writing.", pathResolution: "Every contentFile is resolved relative to the PLAN.json directory.", planSchema: PLAN_SCHEMA, example: PLAN_EXAMPLE, failureExamples: PLAN_FAILURE_EXAMPLES },
+  "validate-maintenance-plan": { usage: "outline-kb validate-maintenance-plan PLAN.json", description: "Validate local maintenance Candidate files without reading or writing Outline. Available only in the system-owned network-maintenance profile.", pathResolution: "Every contentFile is resolved relative to the PLAN.json directory.", planSchema: MAINTENANCE_PLAN_SCHEMA, example: MAINTENANCE_PLAN_EXAMPLE, failureExamples: PLAN_FAILURE_EXAMPLES },
   apply: { usage: "outline-kb apply PLAN.json --collection ID [--root ID]", description: "Preflight all local files and the complete plan, apply it, then return deterministic lint.", pathResolution: "Every contentFile is resolved relative to the PLAN.json directory.", planSchema: PLAN_SCHEMA, example: PLAN_EXAMPLE, failureExamples: PLAN_FAILURE_EXAMPLES },
   lint: { usage: "outline-kb lint --collection ID [--root ID]", description: "Full-library deterministic health check. Do not run inside Query." },
 };
@@ -89,6 +118,7 @@ function successExample(command) {
   }
   if (command === "read") return { ok: true, document: { id: "document-id", title: "Example", path: "wiki/concepts/example", url: "https://outline.example/doc/example", text: "..." } };
   if (command === "validate-plan") return { ok: true, jobId: PLAN_EXAMPLE.jobId, sourceHash: null, operations: PLAN_EXAMPLE.operations };
+  if (command === "validate-maintenance-plan") return { ok: true, jobId: MAINTENANCE_PLAN_EXAMPLE.jobId, sourceHash: null, operations: MAINTENANCE_PLAN_EXAMPLE.operations };
   if (command === "apply") return { ok: true, jobId: PLAN_EXAMPLE.jobId, results: [], lint: { ok: true, errors: [], warnings: [] }, status: "succeeded" };
   return { ok: true };
 }
@@ -822,12 +852,15 @@ export class OutlineWiki {
     const tree = snapshot ?? await this.snapshot();
     const pathOf = new Map(tree.documents.map((document) => [document.id, document.path]));
     const prefix = under ? `${normalizePath(under)}/` : null;
+    const explicitRaw = under ? (normalizePath(under) === "raw" || normalizePath(under).startsWith("raw/")) : false;
     return matches
       .map((document) => {
         const path = pathOf.get(document.id);
         return path === undefined ? null : { ...document, path };
       })
-      .filter((document) => document && (!under || document.path === normalizePath(under) || document.path.startsWith(prefix)))
+      .filter((document) => document
+        && (explicitRaw || !(document.path === "raw" || document.path.startsWith("raw/")))
+        && (!under || document.path === normalizePath(under) || document.path.startsWith(prefix)))
       .slice(0, Math.max(1, Math.min(Number(limit) || 10, 20)));
   }
 
@@ -1068,8 +1101,21 @@ export class OutlineWiki {
       if (operation.type === "update") results.push({ path: operation.path, ...(await this.update(operation.path, operation.content, operation.expectedUpdatedAt, tree)) });
       if (operation.type === "append") results.push({ path: operation.path, ...(await this.appendLog(operation.content, validated.jobId, tree)) });
     }
-    const lint = await this.lint(tree);
-    return { jobId: validated.jobId, results, lint, status: lint.errors.length ? "needs_repair" : "succeeded" };
+    const fullLint = await this.lint(tree);
+    const changedPaths = validated.operations.map((operation) => operation.path);
+    const changesKnowledge = changedPaths.some((path) => path === "raw" || path.startsWith("raw/") || path === "wiki" || path.startsWith("wiki/"));
+    const changesSources = changedPaths.some((path) => path.startsWith("wiki/sources/"));
+    const touchesCurrentChange = (issue) => {
+      const issuePath = typeof issue?.path === "string" ? normalizePath(issue.path) : "";
+      if (!issuePath) return true;
+      if (changesKnowledge && issue.code === "MISSING_REQUIRED") return true;
+      if (changesSources && issue.code === "SOURCE_COUNT_MISMATCH") return true;
+      return changedPaths.some((path) => path === issuePath || path.startsWith(`${issuePath}/`) || issuePath.startsWith(`${path}/`));
+    };
+    const errors = fullLint.errors.filter(touchesCurrentChange);
+    const healthErrors = fullLint.errors.filter((issue) => !touchesCurrentChange(issue));
+    const lint = { ...fullLint, ok: errors.length === 0, errors, ...(healthErrors.length ? { healthErrors } : {}) };
+    return { jobId: validated.jobId, results, lint, status: lint.ok ? "succeeded" : "needs_repair" };
   }
 
   async lint(snapshot = null) {
@@ -1266,16 +1312,17 @@ async function readPlanContent(contentFile, planFile, operation, operationIndex)
   }
 }
 
-async function preflightPlanFiles(plan, planFile = null) {
+async function preflightPlanFiles(plan, planFile = null, options = {}) {
   if (!plan || typeof plan !== "object" || Array.isArray(plan) || !Array.isArray(plan.operations)) {
     throw new OutlineKbError("INVALID_PLAN", "Plan must contain an operations array");
   }
   if (!plan.jobId || typeof plan.jobId !== "string") throw new OutlineKbError("INVALID_PLAN", "Plan requires jobId");
   const seen = new Set();
   const operations = [];
+  const allowedOperationTypes = options.allowedOperationTypes ?? new Set(["create", "update", "append"]);
   for (let index = 0; index < plan.operations.length; index++) {
     const operation = plan.operations[index];
-    if (!operation || !["create", "update", "append"].includes(operation.type)) {
+    if (!operation || !allowedOperationTypes.has(operation.type)) {
       throw new OutlineKbError("INVALID_PLAN", `Unsupported operation at index ${index}`);
     }
     const path = normalizePath(operation.path);
@@ -1287,7 +1334,7 @@ async function preflightPlanFiles(plan, planFile = null) {
     if (path === "log" && operation.type !== "append") throw new OutlineKbError("LOG_APPEND_ONLY", "Plan may only append log");
     if (operation.type === "append" && path !== "log") throw new OutlineKbError("INVALID_PLAN", "append is only supported for log");
     const content = await readPlanContent(operation.contentFile, planFile, operation, index);
-    if (operation.type !== "append") assertDocument(path, content);
+    if (operation.type !== "append" && options.validateMetadata !== false) assertDocument(path, content);
     operations.push({ ...operation, path, content });
   }
   return { jobId: plan.jobId, sourceHash: plan.sourceHash ?? null, operations };
@@ -1342,10 +1389,31 @@ async function run(argv, env = process.env) {
   if (env.OUTLINE_KB_READ_ONLY === "1" && WRITE_COMMANDS.has(command)) {
     throw new OutlineKbError("READ_ONLY", `outline-kb ${command} is disabled for a read-only knowledge query`);
   }
+  if (env.OUTLINE_KB_INGEST_MODE === "1" && INGEST_FORBIDDEN_COMMANDS.has(command)) {
+    throw new OutlineKbError("INGEST_COMMAND_DISABLED", `outline-kb ${command} is disabled until the ingest Candidate is approved`);
+  }
+  if (command === "validate-maintenance-plan" && env.OUTLINE_KB_MAINTENANCE_MODE !== "1") {
+    throw new OutlineKbError("MAINTENANCE_MODE_REQUIRED", "validate-maintenance-plan is only available to a system-owned knowledge maintenance session");
+  }
+  if (env.OUTLINE_KB_MAINTENANCE_MODE === "1" && !MAINTENANCE_ALLOWED_COMMANDS.has(command)) {
+    throw new OutlineKbError("MAINTENANCE_COMMAND_DISABLED", `outline-kb ${command ?? "<missing>"} is disabled for a knowledge maintenance Candidate session`);
+  }
   let planInput = null;
-  if (command === "validate-plan" || command === "apply") {
+  if (command === "validate-plan" || command === "validate-maintenance-plan" || command === "apply") {
     const loaded = await readPlanFile(need(positional[0], `${command} requires a JSON plan file`));
-    planInput = { ...loaded, preflight: await preflightPlanFiles(loaded.plan, loaded.path) };
+    const systemManagedMetadata = command === "validate-maintenance-plan" || (command === "validate-plan"
+      && env.OUTLINE_KB_INGEST_MODE === "1"
+      && env.OASIS_KNOWLEDGE_SYSTEM_METADATA === "1");
+    planInput = {
+      ...loaded,
+      preflight: await preflightPlanFiles(loaded.plan, loaded.path, {
+        validateMetadata: !systemManagedMetadata,
+        ...(command === "validate-maintenance-plan" ? { allowedOperationTypes: new Set(["create", "update"]) } : {}),
+      }),
+    };
+  }
+  if (command === "validate-maintenance-plan") {
+    return { ok: true, ...planInput.preflight };
   }
   const client = new OutlineApiClient({ baseUrl: need(env.OUTLINE_BASE_URL, "OUTLINE_BASE_URL is required"), apiToken: need(env.OUTLINE_API_TOKEN, "OUTLINE_API_TOKEN is required") });
   if (command === "status") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oasis_test",
-  "version": "0.1.128",
+  "version": "0.1.129",
   "description": "Oasis node daemon + CLI — background daemon, auto-start, full server CLI",
   "bin": {
     "oasis": "./dist/index.js"
@@ -26,6 +26,6 @@
     "node": ">=20"
   },
   "oasisRelease": {
-    "sourceHead": "3c7ad5a874aa215ba7cee828b8cab4ab0a499e87"
+    "sourceHead": "d5063bab558443d535d4c4370a53ed4e169e445e"
   }
 }