gsd-pi 2.9.0 → 2.10.1

package/node_modules/@gsd/native/dist/ast/index.d.ts

@@ -0,0 +1,4 @@
+import type { AstFindOptions, AstFindResult, AstReplaceOptions, AstReplaceResult, AstFindMatch, AstReplaceChange, AstReplaceFileChange } from "./types.js";
+export type { AstFindMatch, AstFindOptions, AstFindResult, AstReplaceChange, AstReplaceFileChange, AstReplaceOptions, AstReplaceResult };
+export declare function astGrep(options: AstFindOptions): AstFindResult;
+export declare function astEdit(options: AstReplaceOptions): AstReplaceResult;

package/node_modules/@gsd/native/dist/ast/index.js

@@ -0,0 +1,7 @@
+import { native } from "../native.js";
+export function astGrep(options) {
+    return native.astGrep(options);
+}
+export function astEdit(options) {
+    return native.astEdit(options);
+}

package/node_modules/@gsd/native/dist/ast/types.d.ts

@@ -0,0 +1,69 @@
+export interface AstFindOptions {
+    patterns: string[];
+    lang?: string;
+    path?: string;
+    glob?: string;
+    selector?: string;
+    strictness?: string;
+    limit?: number;
+    offset?: number;
+    includeMeta?: boolean;
+    context?: number;
+}
+export interface AstFindMatch {
+    path: string;
+    text: string;
+    byteStart: number;
+    byteEnd: number;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+    metaVariables?: Record<string, string>;
+}
+export interface AstFindResult {
+    matches: AstFindMatch[];
+    totalMatches: number;
+    filesWithMatches: number;
+    filesSearched: number;
+    limitReached: boolean;
+    parseErrors?: string[];
+}
+export interface AstReplaceOptions {
+    rewrites: Record<string, string>;
+    lang?: string;
+    path?: string;
+    glob?: string;
+    selector?: string;
+    strictness?: string;
+    dryRun?: boolean;
+    maxReplacements?: number;
+    maxFiles?: number;
+    failOnParseError?: boolean;
+}
+export interface AstReplaceChange {
+    path: string;
+    before: string;
+    after: string;
+    byteStart: number;
+    byteEnd: number;
+    deletedLength: number;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}
+export interface AstReplaceFileChange {
+    path: string;
+    count: number;
+}
+export interface AstReplaceResult {
+    changes: AstReplaceChange[];
+    fileChanges: AstReplaceFileChange[];
+    totalReplacements: number;
+    filesTouched: number;
+    filesSearched: number;
+    applied: boolean;
+    limitReached: boolean;
+    parseErrors?: string[];
+}

package/node_modules/@gsd/native/dist/clipboard/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Native clipboard access using N-API.
+ *
+ * Cross-platform clipboard read/write backed by the `arboard` Rust crate.
+ * No external tools (pbcopy, xclip, etc.) required.
+ */
+import type { ClipboardImage } from "./types.js";
+export type { ClipboardImage };
+/**
+ * Copy plain text to the system clipboard.
+ *
+ * Runs synchronously to avoid macOS AppKit pasteboard warnings
+ * when writing from worker threads.
+ */
+export declare function copyToClipboard(text: string): void;
+/**
+ * Read plain text from the system clipboard.
+ *
+ * Returns `null` when no text data is available.
+ */
+export declare function readTextFromClipboard(): string | null;
+/**
+ * Read an image from the system clipboard.
+ *
+ * Returns a Promise that resolves to a `ClipboardImage` (PNG-encoded bytes)
+ * or `null` when no image data is available.
+ */
+export declare function readImageFromClipboard(): Promise<ClipboardImage | null>;

package/node_modules/@gsd/native/dist/clipboard/index.js

@@ -0,0 +1,33 @@
+/**
+ * Native clipboard access using N-API.
+ *
+ * Cross-platform clipboard read/write backed by the `arboard` Rust crate.
+ * No external tools (pbcopy, xclip, etc.) required.
+ */
+import { native } from "../native.js";
+/**
+ * Copy plain text to the system clipboard.
+ *
+ * Runs synchronously to avoid macOS AppKit pasteboard warnings
+ * when writing from worker threads.
+ */
+export function copyToClipboard(text) {
+    native.copyToClipboard(text);
+}
+/**
+ * Read plain text from the system clipboard.
+ *
+ * Returns `null` when no text data is available.
+ */
+export function readTextFromClipboard() {
+    return native.readTextFromClipboard();
+}
+/**
+ * Read an image from the system clipboard.
+ *
+ * Returns a Promise that resolves to a `ClipboardImage` (PNG-encoded bytes)
+ * or `null` when no image data is available.
+ */
+export function readImageFromClipboard() {
+    return native.readImageFromClipboard();
+}

package/node_modules/@gsd/native/dist/clipboard/types.d.ts

@@ -0,0 +1,7 @@
+/** Clipboard image payload encoded as PNG bytes. */
+export interface ClipboardImage {
+    /** PNG-encoded image bytes. */
+    data: Uint8Array;
+    /** MIME type for the encoded image payload (always "image/png"). */
+    mimeType: string;
+}

package/node_modules/@gsd/native/dist/fd/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Native fuzzy file path discovery using N-API.
+ *
+ * High-performance fuzzy file search for autocomplete and @-mention resolution.
+ * Backed by Rust's `ignore` crate for directory walking with subsequence scoring.
+ */
+import type { FuzzyFindMatch, FuzzyFindOptions, FuzzyFindResult } from "./types.js";
+export type { FuzzyFindMatch, FuzzyFindOptions, FuzzyFindResult };
+/**
+ * Fuzzy file path search.
+ *
+ * Searches for files and directories whose paths match the query string.
+ * Results are sorted by match quality (higher score = better match).
+ *
+ * Scoring tiers (highest to lowest):
+ * - 120: exact filename match
+ * - 100: filename starts with query
+ * - 80: filename contains query
+ * - 60: full path contains query
+ * - 50-90: fuzzy subsequence match on filename
+ * - 30-70: fuzzy subsequence match on full path
+ *
+ * Directories receive a +10 score bonus.
+ */
+export declare function fuzzyFind(options: FuzzyFindOptions): FuzzyFindResult;

package/node_modules/@gsd/native/dist/fd/index.js

@@ -0,0 +1,26 @@
+/**
+ * Native fuzzy file path discovery using N-API.
+ *
+ * High-performance fuzzy file search for autocomplete and @-mention resolution.
+ * Backed by Rust's `ignore` crate for directory walking with subsequence scoring.
+ */
+import { native } from "../native.js";
+/**
+ * Fuzzy file path search.
+ *
+ * Searches for files and directories whose paths match the query string.
+ * Results are sorted by match quality (higher score = better match).
+ *
+ * Scoring tiers (highest to lowest):
+ * - 120: exact filename match
+ * - 100: filename starts with query
+ * - 80: filename contains query
+ * - 60: full path contains query
+ * - 50-90: fuzzy subsequence match on filename
+ * - 30-70: fuzzy subsequence match on full path
+ *
+ * Directories receive a +10 score bonus.
+ */
+export function fuzzyFind(options) {
+    return native.fuzzyFind(options);
+}

package/node_modules/@gsd/native/dist/fd/types.d.ts

@@ -0,0 +1,29 @@
+/** Options for fuzzy file path search. */
+export interface FuzzyFindOptions {
+    /** Fuzzy query to match against file paths (case-insensitive). */
+    query: string;
+    /** Directory to search. */
+    path: string;
+    /** Include hidden files (default: false). */
+    hidden?: boolean;
+    /** Respect .gitignore (default: true). */
+    gitignore?: boolean;
+    /** Maximum number of matches to return (default: 100). */
+    maxResults?: number;
+}
+/** A single match in fuzzy find results. */
+export interface FuzzyFindMatch {
+    /** Relative path from the search root (uses `/` separators). Directories have a trailing `/`. */
+    path: string;
+    /** Whether this entry is a directory. */
+    isDirectory: boolean;
+    /** Match quality score (higher is better). */
+    score: number;
+}
+/** Result of fuzzy file path search. */
+export interface FuzzyFindResult {
+    /** Matched entries (up to `maxResults`), sorted by score descending. */
+    matches: FuzzyFindMatch[];
+    /** Total number of matches found (may exceed `matches.length`). */
+    totalMatches: number;
+}

package/node_modules/@gsd/native/dist/glob/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Native glob module using N-API.
+ *
+ * Gitignore-respecting filesystem discovery backed by Rust's `ignore` and
+ * `globset` crates, with an optional TTL-based scan cache for repeated queries.
+ */
+import type { GlobMatch, GlobOptions, GlobResult } from "./types.js";
+export type { FileType, GlobMatch, GlobOptions, GlobResult } from "./types.js";
+/**
+ * Find filesystem entries matching a glob pattern.
+ *
+ * Respects .gitignore by default. Skips `.git` and `node_modules` unless
+ * the pattern explicitly mentions them.
+ *
+ * @param options - Glob search options (pattern, path, filters, etc.)
+ * @param onMatch - Optional streaming callback invoked for each match.
+ * @returns Promise resolving to matched entries.
+ */
+export declare function glob(options: GlobOptions, onMatch?: (match: GlobMatch) => void): Promise<GlobResult>;
+/**
+ * Invalidate the filesystem scan cache.
+ *
+ * Call after file mutations (write, edit, rename, delete) to ensure
+ * subsequent glob queries see fresh data.
+ *
+ * @param path - Specific path to invalidate, or omit to clear all.
+ */
+export declare function invalidateFsScanCache(path?: string): void;

package/node_modules/@gsd/native/dist/glob/index.js

@@ -0,0 +1,31 @@
+/**
+ * Native glob module using N-API.
+ *
+ * Gitignore-respecting filesystem discovery backed by Rust's `ignore` and
+ * `globset` crates, with an optional TTL-based scan cache for repeated queries.
+ */
+import { native } from "../native.js";
+/**
+ * Find filesystem entries matching a glob pattern.
+ *
+ * Respects .gitignore by default. Skips `.git` and `node_modules` unless
+ * the pattern explicitly mentions them.
+ *
+ * @param options - Glob search options (pattern, path, filters, etc.)
+ * @param onMatch - Optional streaming callback invoked for each match.
+ * @returns Promise resolving to matched entries.
+ */
+export function glob(options, onMatch) {
+    return native.glob(options, onMatch);
+}
+/**
+ * Invalidate the filesystem scan cache.
+ *
+ * Call after file mutations (write, edit, rename, delete) to ensure
+ * subsequent glob queries see fresh data.
+ *
+ * @param path - Specific path to invalidate, or omit to clear all.
+ */
+export function invalidateFsScanCache(path) {
+    native.invalidateFsScanCache(path);
+}

package/node_modules/@gsd/native/dist/glob/types.d.ts

@@ -0,0 +1,50 @@
+/** File type classification for filesystem entries. */
+export declare const enum FileType {
+    /** Regular file. */
+    File = 1,
+    /** Directory. */
+    Dir = 2,
+    /** Symbolic link. */
+    Symlink = 3
+}
+/** A single filesystem entry matched by a glob operation. */
+export interface GlobMatch {
+    /** Relative path from the search root, using forward slashes. */
+    path: string;
+    /** Resolved filesystem type for the match. */
+    fileType: FileType;
+    /** Modification time in milliseconds since Unix epoch. */
+    mtime: number | null;
+}
+/** Options for the glob operation. */
+export interface GlobOptions {
+    /** Glob pattern to match (e.g., "*.ts"). */
+    pattern: string;
+    /** Directory to search. */
+    path: string;
+    /** Filter by file type: File (1), Dir (2), or Symlink (3). */
+    fileType?: FileType;
+    /** Match simple patterns recursively by default (default: true). */
+    recursive?: boolean;
+    /** Include hidden files (default: false). */
+    hidden?: boolean;
+    /** Maximum number of results to return. */
+    maxResults?: number;
+    /** Respect .gitignore files (default: true). */
+    gitignore?: boolean;
+    /** Enable shared filesystem scan cache (default: false). */
+    cache?: boolean;
+    /** Sort results by mtime (most recent first) before applying limit. */
+    sortByMtime?: boolean;
+    /** Include node_modules entries (default: false, unless pattern mentions it). */
+    includeNodeModules?: boolean;
+    /** Timeout in milliseconds for the operation. */
+    timeoutMs?: number;
+}
+/** Result payload returned by a glob operation. */
+export interface GlobResult {
+    /** Matched filesystem entries. */
+    matches: GlobMatch[];
+    /** Number of returned matches. */
+    totalMatches: number;
+}

package/node_modules/@gsd/native/dist/glob/types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@gsd/native/dist/grep/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Native ripgrep wrapper using N-API.
+ *
+ * High-performance regex search backed by Rust's grep-* crates
+ * (the same internals as ripgrep).
+ */
+import type { ContextLine, GrepMatch, GrepOptions, GrepResult, SearchMatch, SearchOptions, SearchResult } from "./types.js";
+export type { ContextLine, GrepMatch, GrepOptions, GrepResult, SearchMatch, SearchOptions, SearchResult, };
+/**
+ * Search in-memory content for a regex pattern.
+ *
+ * Accepts a Buffer/Uint8Array of UTF-8 encoded content.
+ */
+export declare function searchContent(content: Buffer | Uint8Array, options: SearchOptions): SearchResult;
+/**
+ * Search files on disk for a regex pattern.
+ *
+ * Walks the directory tree respecting .gitignore and optional glob filters.
+ */
+export declare function grep(options: GrepOptions): GrepResult;

package/node_modules/@gsd/native/dist/grep/index.js

@@ -0,0 +1,23 @@
+/**
+ * Native ripgrep wrapper using N-API.
+ *
+ * High-performance regex search backed by Rust's grep-* crates
+ * (the same internals as ripgrep).
+ */
+import { native } from "../native.js";
+/**
+ * Search in-memory content for a regex pattern.
+ *
+ * Accepts a Buffer/Uint8Array of UTF-8 encoded content.
+ */
+export function searchContent(content, options) {
+    return native.search(content, options);
+}
+/**
+ * Search files on disk for a regex pattern.
+ *
+ * Walks the directory tree respecting .gitignore and optional glob filters.
+ */
+export function grep(options) {
+    return native.grep(options);
+}

package/node_modules/@gsd/native/dist/grep/types.d.ts

@@ -0,0 +1,99 @@
+/** A context line adjacent to a match. */
+export interface ContextLine {
+    /** 1-indexed line number. */
+    lineNumber: number;
+    /** Line content (trailing newline stripped). */
+    line: string;
+}
+/** A single match from in-memory content search. */
+export interface SearchMatch {
+    /** 1-indexed line number. */
+    lineNumber: number;
+    /** The matched line content. */
+    line: string;
+    /** Context lines before the match. */
+    contextBefore: ContextLine[];
+    /** Context lines after the match. */
+    contextAfter: ContextLine[];
+    /** Whether the line was truncated due to maxColumns. */
+    truncated: boolean;
+}
+/** Result of searching in-memory content. */
+export interface SearchResult {
+    /** All matches found. */
+    matches: SearchMatch[];
+    /** Total number of matches (may exceed matches.length due to limit). */
+    matchCount: number;
+    /** Whether the limit was reached. */
+    limitReached: boolean;
+}
+/** Options for in-memory content search. */
+export interface SearchOptions {
+    /** Regex pattern to search for. */
+    pattern: string;
+    /** Case-insensitive matching. */
+    ignoreCase?: boolean;
+    /** Enable multiline regex mode. */
+    multiline?: boolean;
+    /** Maximum number of matches to return. */
+    maxCount?: number;
+    /** Lines of context before matches. */
+    contextBefore?: number;
+    /** Lines of context after matches. */
+    contextAfter?: number;
+    /** Truncate lines longer than this (characters). */
+    maxColumns?: number;
+}
+/** A single match from filesystem search. */
+export interface GrepMatch {
+    /** File path (relative for directory searches). */
+    path: string;
+    /** 1-indexed line number. */
+    lineNumber: number;
+    /** The matched line content. */
+    line: string;
+    /** Context lines before the match. */
+    contextBefore: ContextLine[];
+    /** Context lines after the match. */
+    contextAfter: ContextLine[];
+    /** Whether the line was truncated. */
+    truncated: boolean;
+}
+/** Result of a filesystem search. */
+export interface GrepResult {
+    /** All matches found. */
+    matches: GrepMatch[];
+    /** Total matches across all files. */
+    totalMatches: number;
+    /** Number of files with at least one match. */
+    filesWithMatches: number;
+    /** Number of files searched. */
+    filesSearched: number;
+    /** Whether the limit stopped the search early. */
+    limitReached: boolean;
+}
+/** Options for filesystem search. */
+export interface GrepOptions {
+    /** Regex pattern to search for. */
+    pattern: string;
+    /** Directory or file to search. */
+    path: string;
+    /** Glob filter for filenames (e.g. "*.ts"). */
+    glob?: string;
+    /** Case-insensitive matching. */
+    ignoreCase?: boolean;
+    /** Enable multiline regex mode. */
+    multiline?: boolean;
+    /** Include hidden files (default: false). */
+    hidden?: boolean;
+    /** Respect .gitignore files (default: true). */
+    gitignore?: boolean;
+    /** Maximum number of matches to return. */
+    maxCount?: number;
+    /** Lines of context before matches. */
+    contextBefore?: number;
+    /** Lines of context after matches. */
+    contextAfter?: number;
+    /** Truncate lines longer than this (characters). */
+    maxColumns?: number;
+}

package/node_modules/@gsd/native/dist/grep/types.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@gsd/native/dist/gsd-parser/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * GSD file parser — native Rust implementation.
+ *
+ * Parses `.gsd/` directory markdown files containing YAML-like frontmatter
+ * and structured sections. Replaces the JS regex-based parser for
+ * performance-critical batch operations.
+ */
+import type { BatchParseResult, FrontmatterResult, NativeRoadmap, SectionResult } from "./types.js";
+export type { BatchParseResult, FrontmatterResult, NativeBoundaryMapEntry, NativeRoadmap, NativeRoadmapSlice, ParsedGsdFile, SectionResult, } from "./types.js";
+/**
+ * Parse YAML-like frontmatter from markdown content.
+ *
+ * Returns `{ metadata, body }` where `metadata` is a JSON string
+ * of the parsed frontmatter key-value pairs. Parse it with `JSON.parse()`.
+ */
+export declare function parseFrontmatter(content: string): FrontmatterResult;
+/**
+ * Extract a section from markdown content by heading name.
+ *
+ * @param content  Markdown content to search.
+ * @param heading  Heading text to match (without the `#` prefix).
+ * @param level    Heading level (default 2 for `##`).
+ */
+export declare function extractSection(content: string, heading: string, level?: number): SectionResult;
+/**
+ * Extract all sections at a given heading level.
+ *
+ * Returns a JSON string mapping heading names to their content.
+ * Parse with `JSON.parse()`.
+ */
+export declare function extractAllSections(content: string, level?: number): string;
+/**
+ * Batch-parse all `.md` files in a `.gsd/` directory tree.
+ *
+ * Reads and parses all markdown files under the given directory.
+ * Each file gets frontmatter parsing and section extraction.
+ */
+export declare function batchParseGsdFiles(directory: string): BatchParseResult;
+/**
+ * Parse a roadmap file's content into structured data.
+ *
+ * Extracts title, vision, success criteria, slices (with risk/depends),
+ * and boundary map entries.
+ */
+export declare function parseRoadmapFile(content: string): NativeRoadmap;

package/node_modules/@gsd/native/dist/gsd-parser/index.js

@@ -0,0 +1,54 @@
+/**
+ * GSD file parser — native Rust implementation.
+ *
+ * Parses `.gsd/` directory markdown files containing YAML-like frontmatter
+ * and structured sections. Replaces the JS regex-based parser for
+ * performance-critical batch operations.
+ */
+import { native } from "../native.js";
+/**
+ * Parse YAML-like frontmatter from markdown content.
+ *
+ * Returns `{ metadata, body }` where `metadata` is a JSON string
+ * of the parsed frontmatter key-value pairs. Parse it with `JSON.parse()`.
+ */
+export function parseFrontmatter(content) {
+    return native.parseFrontmatter(content);
+}
+/**
+ * Extract a section from markdown content by heading name.
+ *
+ * @param content  Markdown content to search.
+ * @param heading  Heading text to match (without the `#` prefix).
+ * @param level    Heading level (default 2 for `##`).
+ */
+export function extractSection(content, heading, level) {
+    return native.extractSection(content, heading, level);
+}
+/**
+ * Extract all sections at a given heading level.
+ *
+ * Returns a JSON string mapping heading names to their content.
+ * Parse with `JSON.parse()`.
+ */
+export function extractAllSections(content, level) {
+    return native.extractAllSections(content, level);
+}
+/**
+ * Batch-parse all `.md` files in a `.gsd/` directory tree.
+ *
+ * Reads and parses all markdown files under the given directory.
+ * Each file gets frontmatter parsing and section extraction.
+ */
+export function batchParseGsdFiles(directory) {
+    return native.batchParseGsdFiles(directory);
+}
+/**
+ * Parse a roadmap file's content into structured data.
+ *
+ * Extracts title, vision, success criteria, slices (with risk/depends),
+ * and boundary map entries.
+ */
+export function parseRoadmapFile(content) {
+    return native.parseRoadmapFile(content);
+}

package/node_modules/@gsd/native/dist/gsd-parser/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GSD file parser type definitions.
+ *
+ * Types for the native Rust parser that handles `.gsd/` directory files
+ * containing YAML-like frontmatter and markdown sections.
+ */
+export interface FrontmatterResult {
+    /** Parsed frontmatter as a JSON string of key-value pairs. */
+    metadata: string;
+    /** Body content after the frontmatter block. */
+    body: string;
+}
+export interface SectionResult {
+    /** The section content, or empty string if not found. */
+    content: string;
+    /** Whether the section was found. */
+    found: boolean;
+}
+export interface ParsedGsdFile {
+    /** Relative path from the base directory. */
+    path: string;
+    /** Parsed frontmatter as JSON string. */
+    metadata: string;
+    /** Body content after frontmatter. */
+    body: string;
+    /** Map of section heading to content, serialized as JSON. */
+    sections: string;
+}
+export interface BatchParseResult {
+    /** All parsed files. */
+    files: ParsedGsdFile[];
+    /** Number of files processed. */
+    count: number;
+}
+export interface NativeRoadmapSlice {
+    id: string;
+    title: string;
+    risk: string;
+    depends: string[];
+    done: boolean;
+    demo: string;
+}
+export interface NativeBoundaryMapEntry {
+    fromSlice: string;
+    toSlice: string;
+    produces: string;
+    consumes: string;
+}
+export interface NativeRoadmap {
+    title: string;
+    vision: string;
+    successCriteria: string[];
+    slices: NativeRoadmapSlice[];
+    boundaryMap: NativeBoundaryMapEntry[];
+}

package/node_modules/@gsd/native/dist/gsd-parser/types.js

@@ -0,0 +1,7 @@
+/**
+ * GSD file parser type definitions.
+ *
+ * Types for the native Rust parser that handles `.gsd/` directory files
+ * containing YAML-like frontmatter and markdown sections.
+ */
+export {};