@moxn/kb-migrate 0.4.35 → 0.4.37

package/dist/sources/local.d.ts

@@ -29,6 +29,22 @@ export interface LocalSourceConfig extends SourceConfig {
     /** Date filter for source files */
     dateFilter?: DateFilter;
 }
+/**
+ * A local file to be imported as GRAMMAR markdown (Phase 9a-3).
+ *
+ * The grammar path reads the file VERBATIM (it is already moxn-grammar
+ * markdown — front-matter + body + `:::…` embeds, e.g. produced by the
+ * export) and hands it to `import_markdown`; it does NOT parse to MCP blocks
+ * like the legacy {@link LocalSource.extract} path.
+ */
+export interface GrammarFile {
+    /** Absolute path to the source file on disk (for reading + media base dir). */
+    fullPath: string;
+    /** Original relative path from the scan root (for logging). */
+    sourcePath: string;
+    /** Sanitized KB path the doc maps to (e.g. "subdir/My-Doc"). */
+    kbPath: string;
+}
 /**
  * Local filesystem migration source
  */
@@ -40,6 +56,14 @@ export declare class LocalSource extends MigrationSource<LocalSourceConfig> {
     validate(): Promise<void>;
     getDocumentCount(): Promise<number | undefined>;
     extract(): AsyncGenerator<ExtractedDocument, void, unknown>;
+    /**
+     * Yield local files as GRAMMAR markdown for the `import_markdown` path
+     * (Phase 9a-3). Reuses the SAME discovery + collision-skip + date-filter
+     * logic as {@link extract}, but emits the file's KB path + disk location
+     * instead of parsing to MCP blocks. The runner reads the file verbatim,
+     * uploads + rewrites its media refs, then calls `import_markdown`.
+     */
+    extractGrammarFiles(): AsyncGenerator<GrammarFile, void, unknown>;
     private discoverFiles;
     private extractDocument;
     private parseMarkdownSections;

package/dist/sources/local.js

@@ -75,6 +75,28 @@ export class LocalSource extends MigrationSource {
             }
         }
     }
+    /**
+     * Yield local files as GRAMMAR markdown for the `import_markdown` path
+     * (Phase 9a-3). Reuses the SAME discovery + collision-skip + date-filter
+     * logic as {@link extract}, but emits the file's KB path + disk location
+     * instead of parsing to MCP blocks. The runner reads the file verbatim,
+     * uploads + rewrites its media refs, then calls `import_markdown`.
+     */
+    async *extractGrammarFiles() {
+        if (!this.files) {
+            await this.discoverFiles();
+        }
+        for (const file of this.files) {
+            if (this.skippedCollisions.has(file)) {
+                continue;
+            }
+            yield {
+                fullPath: path.join(this.config.directory, file),
+                sourcePath: file,
+                kbPath: filePathToKbPath(file),
+            };
+        }
+    }
     async discoverFiles() {
         const patterns = this.config.extensions.map((ext) => `**/*${ext.startsWith('.') ? ext : '.' + ext}`);
         const allFiles = [];

package/dist/sources/local.test.js

@@ -20,7 +20,7 @@ describe('sanitizePathSegment', () => {
         expect(sanitizePathSegment('foo@bar!')).toBe('foo-bar');
     });
     it('handles parentheses, ampersands, apostrophes', () => {
-        expect(sanitizePathSegment("Q3 Plan (final)")).toBe('Q3-Plan-final');
+        expect(sanitizePathSegment('Q3 Plan (final)')).toBe('Q3-Plan-final');
         expect(sanitizePathSegment("Tom's & Jerry's")).toBe('Tom-s-Jerry-s');
     });
     it('strips accents via NFKD normalization', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moxn/kb-migrate",
-  "version": "0.4.35",
+  "version": "0.4.37",
   "description": "Migration tool for importing documents into Moxn Knowledge Base from local files, Notion, Google Docs, and more",
   "type": "module",
   "main": "dist/index.js",
@@ -70,6 +70,14 @@
       "types": "./dist/client.d.ts",
       "default": "./dist/client.js"
     },
+    "./grammar-media": {
+      "types": "./dist/grammar-media.d.ts",
+      "default": "./dist/grammar-media.js"
+    },
+    "./import-local": {
+      "types": "./dist/import-local.d.ts",
+      "default": "./dist/import-local.js"
+    },
     "./date-filter": {
       "types": "./dist/date-filter.d.ts",
       "default": "./dist/date-filter.js"