kontexta 4.3.1

package/bundle/standalone/node_modules/kxta-core/dist/files/sections.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Markdown section parsing for the section-level MCP tools.
+ *
+ * Lightweight regex-based parser — the codebase has no markdown AST
+ * dependency and the rules we need are small. Tracks fenced code blocks
+ * so `# foo` inside ``` fences isn't mistaken for a heading.
+ */
+export interface OutlineNode {
+    /** Heading level 1-6 (the count of leading '#'). */
+    level: number;
+    /** Heading text with surrounding whitespace trimmed. */
+    text: string;
+    /** 1-based line number of the heading line. */
+    line: number;
+    /** Byte offset of the heading line's first character. */
+    byteStart: number;
+    /** Byte offset just past the section's body (start of next sibling/parent or EOF). */
+    byteEnd: number;
+    /** Byte offset where the body content starts (line after the heading). */
+    contentStart: number;
+    /** Same as `byteEnd` — body ends where the section ends. */
+    contentEnd: number;
+}
+/**
+ * Parse a markdown document into a flat list of headings + their byte ranges.
+ * Sections nest implicitly via `level`; the byte range of a section runs from
+ * the heading line up to (but not including) the next heading whose level
+ * is ≤ this one's, or EOF.
+ */
+export declare function parseOutline(content: string): OutlineNode[];
+/**
+ * Find a section by heading text (case-insensitive, whitespace-trimmed).
+ * If multiple headings match, prefer the one with the lowest (shallowest)
+ * level — typically what an agent saying "Installation" means.
+ */
+export declare function findSection(content: string, heading: string): OutlineNode | null;
+/**
+ * Replace the BODY of a section, preserving the heading line itself. Body
+ * is everything from the line after the heading up to (but not including)
+ * the next sibling/parent heading.
+ *
+ * `newBody` is inserted verbatim and is sandwiched in newlines so it lands
+ * on its own lines and doesn't fuse with the surrounding text. A trailing
+ * newline is added if the body didn't end with one, so the next section
+ * still starts on a fresh line.
+ */
+export declare function replaceSection(content: string, heading: string, newBody: string): string;
+//# sourceMappingURL=sections.d.ts.map

package/bundle/standalone/node_modules/kxta-core/dist/files/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/files/sections.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CA6D3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAOhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBxF"}

package/bundle/standalone/node_modules/kxta-core/dist/files/sections.js

@@ -0,0 +1,112 @@
+/**
+ * Markdown section parsing for the section-level MCP tools.
+ *
+ * Lightweight regex-based parser — the codebase has no markdown AST
+ * dependency and the rules we need are small. Tracks fenced code blocks
+ * so `# foo` inside ``` fences isn't mistaken for a heading.
+ */
+const HEADING_RE = /^(#{1,6})\s+(.+?)\s*$/;
+const FENCE_RE = /^(```|~~~)/;
+/**
+ * Parse a markdown document into a flat list of headings + their byte ranges.
+ * Sections nest implicitly via `level`; the byte range of a section runs from
+ * the heading line up to (but not including) the next heading whose level
+ * is ≤ this one's, or EOF.
+ */
+export function parseOutline(content) {
+    const lines = content.split("\n");
+    const nodes = [];
+    // Track the byte offset of the start of each line. `+ 1` accounts for the
+    // newline we split on (the final line has no trailing newline; that's fine
+    // because we only ever index into existing line starts).
+    const lineStarts = new Array(lines.length);
+    let cursor = 0;
+    for (let i = 0; i < lines.length; i++) {
+        lineStarts[i] = cursor;
+        cursor += Buffer.byteLength(lines[i], "utf8") + 1;
+    }
+    const totalBytes = Buffer.byteLength(content, "utf8");
+    let inFence = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (FENCE_RE.test(line)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const m = HEADING_RE.exec(line);
+        if (!m)
+            continue;
+        const level = m[1].length;
+        const text = m[2].trim();
+        const byteStart = lineStarts[i];
+        const headingLineBytes = Buffer.byteLength(line, "utf8") + 1; // include trailing \n
+        const contentStart = Math.min(byteStart + headingLineBytes, totalBytes);
+        nodes.push({
+            level,
+            text,
+            line: i + 1,
+            byteStart,
+            byteEnd: totalBytes, // patched below once we know the next sibling/parent
+            contentStart,
+            contentEnd: totalBytes,
+        });
+    }
+    // Walk the headings in order; each section ends where the NEXT heading of
+    // equal-or-lower level (i.e. same or shallower) starts. This matches the
+    // intuitive "## A then ### A.1 then ## B" → A's section runs to B.
+    for (let i = 0; i < nodes.length; i++) {
+        const me = nodes[i];
+        let end = totalBytes;
+        for (let j = i + 1; j < nodes.length; j++) {
+            if (nodes[j].level <= me.level) {
+                end = nodes[j].byteStart;
+                break;
+            }
+        }
+        me.byteEnd = end;
+        me.contentEnd = end;
+    }
+    return nodes;
+}
+/**
+ * Find a section by heading text (case-insensitive, whitespace-trimmed).
+ * If multiple headings match, prefer the one with the lowest (shallowest)
+ * level — typically what an agent saying "Installation" means.
+ */
+export function findSection(content, heading) {
+    const target = heading.trim().toLowerCase();
+    const outline = parseOutline(content);
+    const matches = outline.filter((n) => n.text.toLowerCase() === target);
+    if (matches.length === 0)
+        return null;
+    matches.sort((a, b) => a.level - b.level || a.line - b.line);
+    return matches[0];
+}
+/**
+ * Replace the BODY of a section, preserving the heading line itself. Body
+ * is everything from the line after the heading up to (but not including)
+ * the next sibling/parent heading.
+ *
+ * `newBody` is inserted verbatim and is sandwiched in newlines so it lands
+ * on its own lines and doesn't fuse with the surrounding text. A trailing
+ * newline is added if the body didn't end with one, so the next section
+ * still starts on a fresh line.
+ */
+export function replaceSection(content, heading, newBody) {
+    const node = findSection(content, heading);
+    if (!node) {
+        throw new Error(`Section not found: ${heading}`);
+    }
+    const buf = Buffer.from(content, "utf8");
+    const before = buf.subarray(0, node.contentStart).toString("utf8");
+    const after = buf.subarray(node.contentEnd).toString("utf8");
+    // Ensure the new body is properly terminated so the next section header
+    // isn't pulled up onto the last line of the new body.
+    let body = newBody;
+    if (body.length > 0 && !body.endsWith("\n"))
+        body += "\n";
+    return before + body + after;
+}
+//# sourceMappingURL=sections.js.map

package/bundle/standalone/node_modules/kxta-core/dist/files/sections.js.map

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

package/bundle/standalone/node_modules/kxta-core/dist/git/index.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Git operations module for Kontexta
+ * Handles commit, history, diff, restore, and backup sync operations
+ */
+/** Validate a git remote URL. Allows https://, ssh://, git://, scp-form (user@host:path).
+ *
+ * Rejects http:// — backups containing source code shouldn't transit cleartext
+ * (especially if the URL embeds credentials). Use https:// or ssh:// instead.
+ */
+export declare function isValidGitRemoteUrl(url: string): boolean;
+/**
+ * Ensure a directory is a git repository
+ * @param dir - Directory path
+ */
+export declare function ensureGitRepo(dir: string): Promise<void>;
+/**
+ * Commit a file to git repository
+ * @param repoDir - Root directory of the git repository
+ * @param filePath - Absolute path to the file to commit
+ * @param message - Commit message
+ */
+export declare function commitFile(repoDir: string, filePath: string, message: string): Promise<void>;
+/**
+ * Record a file deletion in git: `git rm -f <path>` + commit.
+ *
+ * Symmetric with `commitFile` — without this, deleteFile() unlinks the file
+ * from disk but git still has it in HEAD. Any subsequent operation that
+ * touches the working tree (a `git pull` from syncGlobalVault, a manual
+ * `git restore`, a stash pop) resurrects the file, and the watcher's `add`
+ * handler then re-indexes it as a new row, making it look like delete
+ * silently "came back".
+ *
+ * Best-effort: if the file isn't in git (untracked) or git fails, we swallow
+ * the error rather than block the delete. The DB/disk delete already
+ * succeeded — leaving an uncommitted delete in the working tree is better
+ * than failing the user's delete action.
+ */
+export declare function commitDelete(repoDir: string, filePath: string, message: string): Promise<void>;
+/**
+ * Get commit history for a file
+ * @param repoDir - Root directory of the git repository
+ * @param filePath - Absolute path to the file
+ * @returns Array of commit history objects
+ */
+export declare function getHistory(repoDir: string, filePath: string): Promise<Array<{
+    hash: string;
+    message: string;
+    date: string;
+    author: string;
+}>>;
+/**
+ * Get diff between two commits for a file
+ * @param repoDir - Root directory of the git repository
+ * @param filePath - Absolute path to the file
+ * @param commitA - First commit hash
+ * @param commitB - Second commit hash
+ * @returns Diff string
+ */
+export declare function getDiff(repoDir: string, filePath: string, commitA: string, commitB: string): Promise<string>;
+/**
+ * Restore a file to a specific commit version
+ * @param repoDir - Root directory of the git repository
+ * @param filePath - Absolute path to the file
+ * @param commitHash - Commit hash to restore from
+ * @returns Content of the file at the specified commit
+ */
+export declare function restoreVersion(repoDir: string, filePath: string, commitHash: string): Promise<string>;
+/**
+ * Sync backup copies of project reference files
+ * @param projectId - ID of the project
+ * @param dataDir - Data directory path
+ * @returns Array of copied file paths
+ */
+/**
+ * Sync the global "vault" — dataDir's own git repo — against the configured
+ * global remote, INDEPENDENT of any project. Picks up KB file commits that
+ * commitFile() made during creates/edits and pushes them upstream.
+ *
+ * Sync All previously only ran pull/push as a side-effect of per-project
+ * `syncBackup` calls, so users with zero projects never had their KB
+ * synced even with a global remote URL configured.
+ */
+export declare function syncGlobalVault(dataDir: string, onStage?: (stage: SyncStage) => void): Promise<void>;
+export declare function getGlobalRemote(dataDir: string): Promise<string | null>;
+export declare function setGlobalRemote(dataDir: string, url: string): Promise<void>;
+/**
+ * Optional per-stage progress callback. Producers (API routes) wire this to
+ * a WS broadcast so the UI can show what git is currently doing.
+ */
+export type SyncStage = "preparing" | "staging local" | "committing local" | "pulling remote" | "merging remote" | "pushing" | "done";
+export declare function syncBackup(projectId: number, dataDir: string, onStage?: (stage: SyncStage) => void): Promise<string[]>;
+//# sourceMappingURL=index.d.ts.map

package/bundle/standalone/node_modules/kxta-core/dist/git/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/git/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0EH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWxD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB9D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAYjF;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA4FjB;AAED;;;;;GAKG;AACH;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GACnC,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS7E;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CjF;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,SAAS,GACT,MAAM,CAAC;AAEX,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GACnC,OAAO,CAAC,MAAM,EAAE,CAAC,CAGnB"}