gennady 0.7.0 → 0.8.0

package/dist/cli/cmd/agent-mon/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the agent-mon command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/agents-rules/agents-rules.cmd.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @purpose Prints agent-facing orient documentation from the gennady package README.md.
+ * @invariant Never modifies the filesystem.
+ * @param _argv CLI arguments (ignored).
+ * @returns Promise<void> — ends with process.exit(0) on success, process.exit(1) on error.
+ * @sideEffect stdout: README.md content on success; stderr: error message on failure.
+ */
+export declare function run(_argv: string[]): Promise<void>;

package/dist/cli/cmd/agents-rules/index.d.ts

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

package/dist/cli/cmd/alt-opinion/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the alt-opinion command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/cat/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the cat command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/commit/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the commit command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/lint/checks/anchor-class-body.check.d.ts

@@ -0,0 +1,11 @@
+import type { LintError } from '../lint.types.js';
+/**
+ * @purpose Detects #region START / #endregion END at class body level.
+ *         Regions are allowed only inside method bodies (brace depth >= 2 inside a class)
+ *         and at top-level (no enclosing class). Regions at class body level (between
+ *         member declarations) are forbidden.
+ * @param content Source text to validate.
+ * @param filePath File path for error messages.
+ * @returns List of lint errors, empty when all regions are correctly placed.
+ */
+export declare function check(content: string, filePath: string): LintError[];

package/dist/cli/cmd/lint/checks/invariant-count.check.d.ts

@@ -0,0 +1,11 @@
+import type { LintError } from '../lint.types.js';
+/**
+ * @purpose Streams through the file tracking brace depth and current enclosing entity.
+ *         Counts @invariant JSDoc tags and invariant: region comments per entity.
+ *         When an entity body closes, checks threshold and emits error if exceeded.
+ * @param content Source text to validate.
+ * @param filePath File path for error messages.
+ * @param maxInvariants Threshold — entities with more invariants trigger an error.
+ * @returns List of lint errors, empty when all entities are within limit.
+ */
+export declare function check(content: string, filePath: string, maxInvariants: number): LintError[];

package/dist/cli/cmd/lint/checks/utils/glob-match.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @purpose Converts a glob pattern to a RegExp for matching file paths.
+ *         Supports: ** (any depth), * (single segment), ? (single char), [abc] (char class).
+ * @param pattern Glob pattern string.
+ * @returns RegExp that matches paths against the pattern.
+ */
+export declare function globToRegex(pattern: string): RegExp;
+/**
+ * @purpose Checks whether a file path matches any of the given glob patterns.
+ * @param filePath Relative file path to check.
+ * @param patterns Array of glob patterns (already compiled or string).
+ * @param [compiled] Optional pre-compiled regexes for performance.
+ * @returns True if the path matches any pattern.
+ */
+export declare function matchesAnyGlob(filePath: string, patterns: string[], compiled?: RegExp[]): boolean;

package/dist/cli/cmd/lint/checks/utils/strip-strings-comments.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @purpose Strips string literals (single/double/template) and line/block comments from a source line,
+ *         returning only the structural characters ({, }) for brace-depth tracking.
+ * @param line Source code line.
+ * @returns Line with strings and comments removed, keeping only code-level braces.
+ */
+export declare function stripStringsAndComments(line: string): string;

package/dist/cli/cmd/lint/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the lint command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/lint/lint.cmd.d.ts

@@ -1,7 +1,7 @@
 import { LintReport } from './lint.types.js';
 import type { LintError } from './lint.types.js';
 /**
- * @purpose Execute the gennady lint command — collect files, run 4 checks, output ESLint-format report.
+ * @purpose Execute the gennady lint command — collect files, run 7 checks, output ESLint-format report.
  * @implements {LintCommand} in specs/cli/lint/lint.spec.md
  * @param rawArgs Raw command-line arguments (process.argv).
  * @returns LintReport with aggregated errors and exit code.

package/dist/cli/cmd/lint/lint.types.d.ts

@@ -70,3 +70,9 @@ export declare const ERR_CLI_LINT_STAGED_CONFLICT: "ERR_CLI_LINT_STAGED_CONFLICT
 export declare const ERR_CLI_LINT_UNAUTHORIZED_DISABLE: "ERR_CLI_LINT_UNAUTHORIZED_DISABLE";
 /** @purpose TypeScript / linter disable comment has a D-NNN reference but lacks a purpose explanation. | @invariant Implements D-007 contract tightening (TSK-52): >= 8 non-whitespace characters of purpose must remain after stripping the comment opener, the marker, and the D-NNN token. */
 export declare const ERR_CLI_LINT_DISABLE_MISSING_PURPOSE: "ERR_CLI_LINT_DISABLE_MISSING_PURPOSE";
+/** @purpose Entity has more invariants than the configured threshold — contract may be overloaded. | @invariant Counts both @invariant JSDoc tags and invariant: in region comments. */
+export declare const ERR_CLI_LINT_TOO_MANY_INVARIANTS: "ERR_CLI_LINT_TOO_MANY_INVARIANTS";
+/** @purpose #region START / #endregion END found at class body level — regions must not separate class members. */
+export declare const ERR_CLI_LINT_ANCHOR_AT_CLASS_BODY: "ERR_CLI_LINT_ANCHOR_AT_CLASS_BODY";
+/** @purpose Two #region START at the same brace depth without an intervening #endregion END — merge or close the first region. */
+export declare const ERR_CLI_LINT_ANCHOR_CONSECUTIVE_START: "ERR_CLI_LINT_ANCHOR_CONSECUTIVE_START";

package/dist/cli/cmd/orient/core/build-index.d.ts

@@ -0,0 +1,8 @@
+import type { FileWordRef, ScannedFile } from '../orient.types.js';
+/**
+ * @purpose Build an inverted index: word -> Set of {file, source, entity?} references.
+ * @invariant Words lowercased, split on non-alphanumeric boundaries, extracted from @file: value and entity @purpose text.
+ * @param files Scanned files with parsed headers and exports.
+ * @returns Map from normalized word to matching FileWordRef set.
+ */
+export declare function buildIndex(files: ScannedFile[]): Map<string, Set<FileWordRef>>;

package/dist/cli/cmd/orient/core/damerau-levenshtein.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @purpose Compute the Damerau-Levenshtein distance between two strings.
+ * @invariant Supports insertion, deletion, substitution, transposition; distance 0 for identical strings.
+ * @param a First string.
+ * @param b Second string.
+ * @returns Edit distance (non-negative integer).
+ */
+export declare function damerauLevenshtein(a: string, b: string): number;
+/**
+ * @purpose Determine if two strings match within the fuzzy threshold.
+ * @invariant Threshold <=2 for strings of length <=5; <=3 for length >5.
+ * @param query Requested term.
+ * @param candidate Indexed term to compare against.
+ * @returns True when DL distance is within the applicable threshold.
+ */
+export declare function isFuzzyMatch(query: string, candidate: string): boolean;
+/**
+ * @purpose Compute DL distance and return it with the match verdict.
+ * @param query Requested term.
+ * @param candidate Indexed term to compare against.
+ * @returns Distance value and whether it is within the threshold.
+ */
+export declare function fuzzyDistance(query: string, candidate: string): {
+    distance: number;
+    match: boolean;
+};

package/dist/cli/cmd/orient/core/extract-header.d.ts

@@ -0,0 +1,8 @@
+import type { FileHeader } from '../orient.types.js';
+/**
+ * @purpose Parse // @tag: directives from file content before the first import.
+ * @invariant Scans only lines before the first `import ` statement.
+ * @param content Raw file content.
+ * @returns Parsed FileHeader with file, tasks, and consumers fields.
+ */
+export declare function extractHeader(content: string): FileHeader;

package/dist/cli/cmd/orient/core/hints.d.ts

@@ -0,0 +1,9 @@
+import type { OrientArgs } from '../orient.types.js';
+/**
+ * @purpose Generate up to 4 contextual hints based on the current query mode.
+ * @invariant Hints use the syntax `<cmd> --flag=<value>` or `--flag`.
+ * @invariant `<cmd>` is replaced with `orient`.
+ * @param args Parsed CLI arguments.
+ * @returns Array of hint strings (max 4).
+ */
+export declare function generateHints(args: OrientArgs): string[];

package/dist/cli/cmd/orient/core/query-consumer.d.ts

@@ -0,0 +1,10 @@
+import type { ScannedFile, ConsumerQueryResult } from '../orient.types.js';
+/**
+ * @purpose Find all files whose @consumers: header contains the given consumer name.
+ * @invariant Supports exact match, substring match, and fuzzy (--fuzzy) via DL distance.
+ * @param files All scanned project files.
+ * @param consumerNames One or more consumer names to search for.
+ * @param useFuzzy When true, use Damerau-Levenshtein for fuzzy matching.
+ * @returns Grouped query results per consumer name.
+ */
+export declare function queryConsumer(files: ScannedFile[], consumerNames: string[], useFuzzy: boolean): ConsumerQueryResult[];

package/dist/cli/cmd/orient/core/query-entity.d.ts

@@ -0,0 +1,11 @@
+import type { ScannedFile, EntityMatch } from '../orient.types.js';
+/**
+ * @purpose Find exported entities by name — exact match or fuzzy via DL distance.
+ * @invariant Only exported entities are matched — class methods are NOT included.
+ * @invariant Fuzzy threshold: <=2 for short (<=5 chars), <=3 for long (>5).
+ * @param files All scanned project files.
+ * @param entityNames One or more entity names to search for.
+ * @param useFuzzy When true, use DL for fuzzy matching.
+ * @returns Matched entities with their file and contract info.
+ */
+export declare function queryEntity(files: ScannedFile[], entityNames: string[], useFuzzy: boolean): EntityMatch[];

package/dist/cli/cmd/orient/core/query-graph.d.ts

@@ -0,0 +1,18 @@
+import type { ScannedFile, GraphNode } from '../orient.types.js';
+/**
+ * @purpose Build a consumer dependency graph from scanned files.
+ * @invariant Consumer names are extracted from @consumers: headers.
+ * @invariant Consumer name matching a file name resolves to that file; otherwise it is a text node.
+ * @param files All scanned project files.
+ * @returns Map of consumer name to GraphNode.
+ */
+export declare function buildGraph(files: ScannedFile[]): Map<string, GraphNode>;
+/**
+ * @purpose Build a recursive dependency tree from the flat graph.
+ * @invariant Detects and marks circular dependencies with `[circular]`.
+ * @param graph Flat graph map from buildGraph.
+ * @param rootConsumer Root consumer name to start from.
+ * @param maxDepth Maximum recursion depth.
+ * @returns Indented tree lines.
+ */
+export declare function buildRecursiveTree(graph: Map<string, GraphNode>, rootConsumer: string, maxDepth: number): string[];

package/dist/cli/cmd/orient/core/query-keyword.d.ts

@@ -0,0 +1,10 @@
+import type { ScannedFile, KeywordMatch, FileWordRef } from '../orient.types.js';
+/**
+ * @purpose Search files by keyword with three-level scoring: exact (+10), prefix (+5), fuzzy (+3).
+ * @invariant AND semantics across tokens; scoring: exact (+10) > prefix (+5) > fuzzy (+3).
+ * @param files All scanned project files.
+ * @param index Inverted word index built by buildIndex.
+ * @param query Lowercased keyword query.
+ * @returns Scored keyword matches sorted by relevance descending.
+ */
+export declare function queryKeyword(files: ScannedFile[], index: Map<string, Set<FileWordRef>>, query: string): KeywordMatch[];

package/dist/cli/cmd/orient/core/query-spec.d.ts

@@ -0,0 +1,15 @@
+import type { SpecOverview } from '../orient.types.js';
+/**
+ * @purpose Scan specs/ directory and build overview of spec files with their task references.
+ * @invariant Recursively walks specs/, parses task files to link specs to task IDs.
+ * @param projectRoot Absolute project root path.
+ * @returns Array of SpecOverview entries.
+ */
+export declare function loadSpecOverview(projectRoot: string): SpecOverview[];
+/**
+ * @purpose Search for a specific spec file by name and return its tasks-to-files mapping.
+ * @param projectRoot Absolute project root path.
+ * @param specName Spec file name to search for.
+ * @returns Spec overview entry or null if not found.
+ */
+export declare function searchSpec(projectRoot: string, specName: string): SpecOverview | null;

package/dist/cli/cmd/orient/core/query-task.d.ts

@@ -0,0 +1,8 @@
+import type { ScannedFile, TaskQueryResult } from '../orient.types.js';
+/**
+ * @purpose Find all files tagged with the given task ID in their @tasks: header.
+ * @param files All scanned project files.
+ * @param taskIds One or more task IDs to search for.
+ * @returns Grouped query results per task ID.
+ */
+export declare function queryTask(files: ScannedFile[], taskIds: string[]): TaskQueryResult[];

package/dist/cli/cmd/orient/core/scan-files.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @purpose Scan a directory recursively for .ts/.tsx files, excluding system dirs.
+ * @invariant Excludes hidden dirs (starts with `.`), EXCLUDED_DIRS, symlinks.
+ * @invariant EACCES errors are silently skipped — scan continues.
+ * @param dir Absolute or relative directory path to scan.
+ * @returns Sorted array of absolute file paths.
+ */
+export declare function scanFiles(dir: string): string[];

package/dist/cli/cmd/orient/help.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @purpose Print help text for the gennady orient command.
+ * @sideEffect Console: writes usage, options, and examples to stdout.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/orient/index.d.ts

@@ -0,0 +1 @@
+import './orient.cmd.ts';

package/dist/cli/cmd/orient/orient.cmd.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @purpose CLI entry point for gennady orient: routes to S1-S9 handlers based on parsed args.
+ * @param rawArgs Raw process.argv array.
+ * @returns Promise<void> — resolves after all console output is written.
+ * @sideEffect File system: reads .ts files via scanFiles; console output via render functions.
+ */
+export declare function run(rawArgs: string[]): Promise<void>;

package/dist/cli/cmd/orient/orient.types.d.ts

@@ -0,0 +1,136 @@
+import type { DbcSchema } from '../../../services/dbc/parser/dbc-parser.types.js';
+/** @purpose Parsed file header tags extracted from top-of-file // @tag: comments. */
+export type FileHeader = {
+    /** @purpose Value of // @file: directive */
+    file: string;
+    /** @purpose Task IDs from // @tasks: directive */
+    tasks: string[];
+    /** @purpose Consumer names from // @consumers: directive */
+    consumers: string[];
+};
+/** @purpose Single exported entity with its JSDoc contract and source location. */
+export type ExportedEntity = {
+    /** @purpose Entity name (function name, class name, type name, const name) */
+    name: string;
+    /** @purpose Entity kind — class, function, const, type, interface, enum */
+    kind: 'class' | 'function' | 'const' | 'type' | 'interface' | 'enum';
+    /** @purpose Parsed DBC contract schema from JSDoc */
+    contract: DbcSchema;
+    /** @purpose Raw JSDoc text block */
+    rawJsdoc: string;
+};
+/** @purpose A file scanned by orient with its header, exports, and path. */
+export type ScannedFile = {
+    /** @purpose Absolute path to the file */
+    absPath: string;
+    /** @purpose Parsed file header */
+    header: FileHeader;
+    /** @purpose Exported entities with DBC contracts */
+    exports: ExportedEntity[];
+};
+/** @purpose Reference from a word in @file:/@purpose back to a file and optional entity. */
+export type FileWordRef = {
+    /** @purpose Absolute file path */
+    file: string;
+    /** @purpose Source tag — 'file' (@file:) or 'entity' (@purpose) */
+    source: 'file' | 'entity';
+    /** @purpose Entity name when source is 'entity' */
+    entity?: string;
+};
+/** @purpose CLI argument bundle parsed from raw args. */
+export type OrientArgs = {
+    /** @purpose Positional arguments (keywords for S4 search) */
+    _: string[];
+    /** @purpose File paths for S5 detailed view (repeatable) */
+    file: string[];
+    /** @purpose Directory to limit scanning scope */
+    dir: string;
+    /** @purpose Task IDs for S2 file lookup (repeatable) */
+    task: string[];
+    /** @purpose Consumer names for S3 lookup (repeatable) */
+    consumer: string[];
+    /** @purpose Entity names for S6 search (repeatable) */
+    entity: string[];
+    /** @purpose Trigger S7 dependency graph mode */
+    graph: boolean;
+    /** @purpose Expand graph recursively */
+    recursive: boolean;
+    /** @purpose Trigger S8 specs overview mode */
+    specs: boolean;
+    /** @purpose Specific spec name for S9 search */
+    spec: string;
+    /** @purpose Include DBC contract details in output */
+    detail: boolean;
+    /** @purpose Enable fuzzy matching for --entity and --consumer */
+    fuzzy: boolean;
+    /** @purpose Maximum tree or graph depth */
+    depth: number;
+    /** @purpose Maximum files shown before overflow indicator */
+    maxResults: number;
+};
+/** @purpose Query result from a task search (S2). */
+export type TaskQueryResult = {
+    /** @purpose Task ID that was searched */
+    taskId: string;
+    /** @purpose Matching files */
+    files: ScannedFile[];
+};
+/** @purpose Query result from a consumer search (S3). */
+export type ConsumerQueryResult = {
+    /** @purpose Consumer name that was searched */
+    consumerName: string;
+    /** @purpose Matching files */
+    files: ScannedFile[];
+};
+/** @purpose Single keyword match with score for ranking. */
+export type KeywordMatch = {
+    /** @purpose File reference */
+    file: ScannedFile;
+    /** @purpose Match score — higher = more relevant */
+    score: number;
+    /** @purpose Matched entity name when match is in @purpose */
+    entityName?: string;
+};
+/** @purpose Entity search match. */
+export type EntityMatch = {
+    /** @purpose Entity name */
+    name: string;
+    /** @purpose Entity kind */
+    kind: string;
+    /** @purpose File where found */
+    filePath: string;
+    /** @purpose DBC contract entries */
+    contract: DbcSchema;
+    /** @purpose Whether match was fuzzy */
+    fuzzy: boolean;
+    /** @purpose DL distance when fuzzy */
+    distance?: number;
+};
+/** @purpose Consumer dependency edge in the architecture graph. */
+export type GraphNode = {
+    /** @purpose Consumer name */
+    consumer: string;
+    /** @purpose Files that declare this consumer */
+    files: string[];
+    /** @purpose Consumer nodes that consume THIS consumer (reverse — who depends on this) */
+    consumedBy: string[];
+    /** @purpose Is this consumer unresolved (not matching a real file)? */
+    unresolved: boolean;
+};
+/** @purpose Spec overview entry for S8/S9. */
+export type SpecOverview = {
+    /** @purpose Spec file path */
+    specPath: string;
+    /** @purpose Task IDs referenced by this spec's tasks */
+    taskIds: string[];
+    /** @purpose Whether this is a library-level spec (no own tasks, has sub-specs) */
+    isLibraryLevel: boolean;
+    /** @purpose Sub-spec paths for library-level specs */
+    subSpecs: string[];
+};
+/**
+ * @purpose Parse raw CLI args into a typed OrientArgs struct.
+ * @param rawArgs Raw process.argv array.
+ * @returns Fully populated OrientArgs with defaults.
+ */
+export declare function parseOrientArgs(rawArgs: string[]): OrientArgs;

package/dist/cli/cmd/orient/render/render-detail.d.ts

@@ -0,0 +1,10 @@
+import type { ScannedFile } from '../orient.types.js';
+/**
+ * @purpose Render a detailed view of one or more files with full DBC contracts.
+ * @invariant Renders file header block, then each exported entity with all DBC tags.
+ * @invariant Functions show signatures; classes show methods.
+ * @param files Scanned files to render in detail.
+ * @param projectRoot Absolute project root.
+ * @returns Array of formatted output lines.
+ */
+export declare function renderDetail(files: ScannedFile[], projectRoot: string): string[];

package/dist/cli/cmd/orient/render/render-file-list.d.ts

@@ -0,0 +1,15 @@
+import type { ScannedFile } from '../orient.types.js';
+/**
+ * @purpose Format a single file line in universal format.
+ * @param file Scanned file with header and exports.
+ * @param projectRoot Absolute project root for relative path display.
+ * @returns Formatted line string.
+ */
+export declare function renderFileLine(file: ScannedFile, projectRoot: string): string;
+/**
+ * @purpose Render a list of files in universal format.
+ * @param files Scanned files to render.
+ * @param projectRoot Absolute project root for relative path display.
+ * @returns Array of formatted lines.
+ */
+export declare function renderFileList(files: ScannedFile[], projectRoot: string): string[];

package/dist/cli/cmd/orient/render/render-graph.d.ts

@@ -0,0 +1,13 @@
+import type { GraphNode } from '../orient.types.js';
+/**
+ * @purpose Render a flat consumer dependency graph.
+ * @param graph Map of consumer name to GraphNode.
+ * @returns Array of formatted output lines.
+ */
+export declare function renderGraph(graph: Map<string, GraphNode>): string[];
+/**
+ * @purpose Render a recursive dependency graph as indented tree.
+ * @param treeLines Pre-computed recursive tree lines.
+ * @returns Array of formatted output lines.
+ */
+export declare function renderRecursiveGraph(treeLines: string[]): string[];

package/dist/cli/cmd/orient/render/render-search.d.ts

@@ -0,0 +1,8 @@
+import type { KeywordMatch } from '../orient.types.js';
+/**
+ * @purpose Render keyword search results sorted by score.
+ * @param matches Scored keyword matches.
+ * @param projectRoot Absolute project root.
+ * @returns Array of formatted output lines.
+ */
+export declare function renderSearch(matches: KeywordMatch[], projectRoot: string): string[];

package/dist/cli/cmd/orient/render/render-specs.d.ts

@@ -0,0 +1,13 @@
+import type { SpecOverview } from '../orient.types.js';
+/**
+ * @purpose Render a list of all specs with their task-to-file mappings.
+ * @param overviews All spec overview entries.
+ * @returns Array of formatted output lines.
+ */
+export declare function renderSpecsOverview(overviews: SpecOverview[]): string[];
+/**
+ * @purpose Render a single spec's task-to-file details.
+ * @param overview Single spec overview entry.
+ * @returns Array of formatted output lines.
+ */
+export declare function renderSpecSearch(overview: SpecOverview): string[];

package/dist/cli/cmd/orient/render/render-tree.d.ts

@@ -0,0 +1,13 @@
+import type { ScannedFile } from '../orient.types.js';
+/**
+ * @purpose Render a directory tree of scanned files with annotations and depth control.
+ * @invariant Directories show `... N more dirs/dir, M files/file` when depth is exceeded.
+ * @invariant Singular/plural distinction for count indicators.
+ * @param files Scanned files.
+ * @param projectRoot Absolute project root.
+ * @param maxDepth Maximum tree depth (1-indexed).
+ * @param showDetail When true, include entity details under each file.
+ * @param maxResults Maximum files to show before overflow indicator.
+ * @returns Array of formatted output lines.
+ */
+export declare function renderTree(files: ScannedFile[], projectRoot: string, maxDepth: number, showDetail: boolean, maxResults: number): string[];

package/dist/cli/cmd/remote-console/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the remote-console command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/resolve-conflicts/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the resolve-conflicts command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/review/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the review command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/review-issues/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the review-issues command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/review-verify/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the review-verify command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/sync/help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @purpose Print CLI help for the sync command.
+ */
+export declare function printHelp(): void;

package/dist/cli/cmd/sync/sync-core.d.ts

@@ -43,11 +43,12 @@ export interface SyncCoreDeps {
     cwd: string;
 }
 /**
- * @purpose Find the ai/directives/ directory in the installed gennady npm package.
+ * @purpose Locate ai/directives/ in the installed gennady package. Delegates to shared resolvePackageDir.
  * @param cwd Current working directory.
+ * @param [subdir] Subdirectory inside gennady package (defaults to 'ai/directives').
  * @returns Absolute path to ai/directives/ or null if the package is not found.
  */
-export declare function resolvePackageDir(cwd: string): string | null;
+export declare function resolvePackageDir(cwd: string, subdir?: string): string | null;
 /**
  * @purpose Recursively collect a list of files in sourceDir with filter and exclusion support.
  * @param sourceDir Source directory to scan.

package/dist/cli/cmd/sync/sync-formatter.d.ts

@@ -1,12 +1,11 @@
 import type { SyncFileEntry } from './sync.types.js';
-interface FormatOpts {
-    dryRun?: boolean;
-}
+export { formatSyncOutput } from '../../../shared/common/sync/sync-formatter.shared.js';
 /**
- * @purpose Format a list of sync file entries into stdout lines.
- * @param entries List of sync file entries to format.
- * @param [opts] Formatting options (dryRun enables would-add/would-update labels).
- * @returns Array of formatted lines, last line is the summary.
+ * @purpose Backward-compat alias for shared formatSyncOutput.
+ * @param entries List of sync file entries.
+ * @param [opts] Formatting options.
+ * @returns Array of formatted stdout lines.
  */
-export declare function formatEntries(entries: SyncFileEntry[], opts?: FormatOpts): string[];
-export {};
+export declare function formatEntries(entries: SyncFileEntry[], opts?: {
+    dryRun?: boolean;
+}): string[];

package/dist/cli/cmd/sync/sync.cmd.d.ts

@@ -1,24 +1,5 @@
-import { readFileSync, writeFileSync, mkdirSync, statSync, readdirSync } from 'node:fs';
-import { resolvePackageDir } from './sync-core.js';
-/** @purpose Injectable dependencies for the sync CLI command — enables testing without real FS. */
-export type SyncCmdDeps = {
-    /** @purpose Read file from disk. */
-    readFile?: typeof readFileSync;
-    /** @purpose Write file to disk. */
-    writeFile?: typeof writeFileSync;
-    /** @purpose Create directory. */
-    mkdir?: typeof mkdirSync;
-    /** @purpose Get file stats. */
-    stat?: typeof statSync;
-    /** @purpose List directory contents. */
-    readdir?: typeof readdirSync;
-    /** @purpose Resolve package directory. */
-    resolvePackageDir?: typeof resolvePackageDir;
-    /** @purpose Standard output stream. */
-    stdout?: NodeJS.WriteStream;
-    /** @purpose Standard error stream. */
-    stderr?: NodeJS.WriteStream;
-};
+import type { SyncCmdDeps } from '../../../shared/common/sync/sync-deps.type.js';
+export type { SyncCmdDeps } from '../../../shared/common/sync/sync-deps.type.js';
 /**
  * @purpose CLI entry point for the sync command.
  * *

package/dist/cli/cmd/sync-skills/index.d.ts

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