@lzehrung/codegraph 2.1.0

package/dist/languages/types.d.ts

@@ -0,0 +1,110 @@
+import type { ParserLanguage, ParserSyntaxNode, SyntaxPoint } from "../parserBackend.js";
+export type { ParserLanguage };
+export type SyntaxPositionLike = SyntaxPoint;
+export type SyntaxNodeLike = ParserSyntaxNode;
+export interface SyntaxTreeLike {
+    rootNode: SyntaxNodeLike & {
+        descendantForIndex(startIndex: number, endIndex: number): SyntaxNodeLike;
+        descendantForPosition(start: SyntaxPositionLike, end: SyntaxPositionLike): SyntaxNodeLike;
+    };
+}
+export type NativeQueryKind = "imports" | "exports" | "locals" | "importBindings";
+export type NativeCompatibilityQueryKind = NativeQueryKind | "adHoc";
+export interface NativeCompatibility {
+    normalizeQuery?: (kind: NativeCompatibilityQueryKind, query: string) => string;
+    authoritativeKinds?: NativeQueryKind[];
+    notes?: string[];
+}
+export interface LanguageDefinition {
+    id: string;
+    extensions: string[];
+    grammar: (filename?: string) => ParserLanguage;
+    /**
+     * Configuration for semantic chunking.
+     * Defines how to split code into meaningful blocks.
+     */
+    structure: {
+        /** Node types that represent cohesive units (functions, classes) */
+        blocks: BlockDefinition[];
+        /** Node types that represent inner control flow to split on (if, loops) */
+        splitPoints: string[];
+        /** Node types for comments */
+        comments: string[];
+    };
+    /**
+     * Configuration for dependency graphing and symbol indexing.
+     */
+    graph: {
+        /** Tree-sitter query string for imports */
+        imports: string;
+        /** Tree-sitter query string for exports */
+        exports: string;
+        /** Tree-sitter query string for local definitions */
+        locals: string;
+        /** Tree-sitter query string for import bindings */
+        importBindings: string;
+    };
+    /**
+     * Whether native local-definition captures are authoritative for this language.
+     */
+    usesQueryDrivenLocals?: boolean;
+    /**
+     * Helper to classify a definition node (function vs class vs var).
+     */
+    classifyDefinition?: (node: SyntaxNodeLike) => string;
+    /**
+     * Helper to check if a node is a declaration name.
+     */
+    isDeclarationName?: (node: SyntaxNodeLike) => boolean;
+    /**
+     * Names that must be registered by scope construction in addition to its
+     * structural declaration handling. "all" preserves a language's established
+     * declaration-name semantics; a predicate can opt in a missing node shape.
+     */
+    scopeDeclarationNames?: "all" | ((node: SyntaxNodeLike) => boolean);
+    /**
+     * Normalizes syntax-specific identifier spelling for lexical scope matching.
+     */
+    normalizeIdentifier?: (name: string) => string;
+    /**
+     * Helper to check if a node creates a block scope.
+     */
+    createsBlockScope?: (node: SyntaxNodeLike) => boolean;
+    /**
+     * Helper to check if a node creates a function scope.
+     */
+    createsFunctionScope?: (node: SyntaxNodeLike) => boolean;
+    /**
+     * Whether an unqualified call within a type can resolve to one of its members.
+     */
+    membersAreImplicitlyInScope?: boolean;
+    /**
+     * Whether the language supports cross-module symbol resolution.
+     */
+    supportsCrossModuleSymbols?: boolean;
+    /**
+     * Helper to check if a statement represents a type-only dependency.
+     */
+    isTypeOnly?: (stmtText: string) => boolean;
+    /**
+     * Specific node types used for symbol resolution
+     */
+    nodeTypes?: {
+        identifier: string[];
+        propertyIdentifier?: string[];
+        shorthandPropertyIdentifier?: string[];
+        memberExpression?: string;
+    };
+    /**
+     * Optional native-runtime compatibility hooks for grammar/query differences.
+     */
+    native?: NativeCompatibility;
+}
+export interface BlockDefinition {
+    type: string;
+    nameQuery?: string;
+    captureId?: string;
+    parentType?: string;
+    isBlock?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/languages/types.d.ts.map

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

package/dist/languages/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/languages/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/languages/types.ts"],"names":[],"mappings":""}

package/dist/languages.d.ts

@@ -0,0 +1,63 @@
+import type { ParserLanguage, NativeCompatibility, SyntaxNodeLike } from "./languages/types.js";
+import "./languages/all.js";
+export type IdentifierNodeType = string;
+export type LanguageSupport = {
+    id: string;
+    matchExts: string[];
+    language: (filename: string) => ParserLanguage;
+    nodeTypes: {
+        identifier: IdentifierNodeType[];
+        propertyIdentifier?: IdentifierNodeType[];
+        shorthandPropertyIdentifier?: IdentifierNodeType[];
+        memberExpression?: string;
+    };
+    queries: {
+        imports: string;
+        exports: string;
+        locals: string;
+        importBindings: string;
+    };
+    classifyDefinition: (nameNode: SyntaxNodeLike) => string;
+    isDeclarationName: (node: SyntaxNodeLike) => boolean;
+    scopeDeclarationNames: (node: SyntaxNodeLike) => boolean;
+    createsBlockScope: (node: SyntaxNodeLike) => boolean;
+    createsFunctionScope: (node: SyntaxNodeLike) => boolean;
+    membersAreImplicitlyInScope: boolean;
+    supportsCrossModuleSymbols: boolean;
+    isTypeOnly: (stmtText: string) => boolean;
+    usesQueryDrivenLocals: boolean;
+    native?: NativeCompatibility;
+    normalizeIdentifier: (name: string) => string;
+};
+export declare const TS_SUPPORT: LanguageSupport;
+export declare const TSX_SUPPORT: LanguageSupport;
+export declare const JS_SUPPORT: LanguageSupport;
+export declare const PY_SUPPORT: LanguageSupport;
+export declare const PHP_SUPPORT: LanguageSupport;
+export declare const HTML_SUPPORT: LanguageSupport;
+export declare const CSS_SUPPORT: LanguageSupport;
+export declare const SCSS_SUPPORT: LanguageSupport;
+export declare const LESS_SUPPORT: LanguageSupport;
+export declare const VUE_SUPPORT: LanguageSupport;
+export declare const SVELTE_SUPPORT: LanguageSupport;
+export declare const RUBY_SUPPORT: LanguageSupport;
+export declare const GO_SUPPORT: LanguageSupport;
+export declare const JAVA_SUPPORT: LanguageSupport;
+export declare const CSHARP_SUPPORT: LanguageSupport;
+export declare const RUST_SUPPORT: LanguageSupport;
+export declare const C_SUPPORT: LanguageSupport;
+export declare const CPP_SUPPORT: LanguageSupport;
+export declare const KOTLIN_SUPPORT: LanguageSupport;
+export declare const SWIFT_SUPPORT: LanguageSupport;
+export declare const ZIG_SUPPORT: LanguageSupport;
+export declare const SQL_SUPPORT: LanguageSupport;
+export declare const LANGUAGE_SUPPORTS: LanguageSupport[];
+export type LanguageExtensionMap = Record<string, string>;
+export declare function isLiteralLanguageExtension(extension: string): boolean;
+export declare function isRemappableLanguageExtension(extension: string): boolean;
+export declare function normalizeLanguageExtensions(extensions: LanguageExtensionMap | undefined): LanguageExtensionMap | undefined;
+export declare function languageExtensionPatterns(extensions: LanguageExtensionMap | undefined): string[];
+export declare function supportForFile(filename: string, extensionMap?: LanguageExtensionMap | undefined): LanguageSupport | undefined;
+export declare function languageForFile(filename: string, extensionMap?: LanguageExtensionMap | undefined): ParserLanguage;
+export declare function supportById(id: string): LanguageSupport | undefined;
+//# sourceMappingURL=languages.d.ts.map

package/dist/languages.d.ts.map

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

package/dist/languages.js

@@ -0,0 +1,118 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getAllLanguages, getLanguageById } from "./languages/registry.js";
+import "./languages/all.js";
+function adaptDefinition(def) {
+    return {
+        id: def.id,
+        matchExts: def.extensions,
+        language: (filename) => def.grammar(filename),
+        nodeTypes: def.nodeTypes || { identifier: ["identifier"] },
+        queries: def.graph,
+        classifyDefinition: def.classifyDefinition || (() => "variable"),
+        isDeclarationName: def.isDeclarationName || (() => false),
+        scopeDeclarationNames: def.scopeDeclarationNames === "all" ? () => true : (def.scopeDeclarationNames ?? (() => false)),
+        createsBlockScope: def.createsBlockScope || (() => false),
+        createsFunctionScope: def.createsFunctionScope || (() => false),
+        membersAreImplicitlyInScope: def.membersAreImplicitlyInScope ?? true,
+        supportsCrossModuleSymbols: def.supportsCrossModuleSymbols || false,
+        isTypeOnly: def.isTypeOnly || (() => false),
+        usesQueryDrivenLocals: def.usesQueryDrivenLocals || false,
+        normalizeIdentifier: def.normalizeIdentifier || ((name) => name),
+        ...(def.native ? { native: def.native } : {}),
+    };
+}
+export const TS_SUPPORT = adaptDefinition(getLanguageById("ts"));
+export const TSX_SUPPORT = adaptDefinition(getLanguageById("tsx"));
+export const JS_SUPPORT = adaptDefinition(getLanguageById("js"));
+export const PY_SUPPORT = adaptDefinition(getLanguageById("python"));
+export const PHP_SUPPORT = adaptDefinition(getLanguageById("php"));
+export const HTML_SUPPORT = adaptDefinition(getLanguageById("html"));
+export const CSS_SUPPORT = adaptDefinition(getLanguageById("css"));
+export const SCSS_SUPPORT = adaptDefinition(getLanguageById("scss"));
+export const LESS_SUPPORT = adaptDefinition(getLanguageById("less"));
+export const VUE_SUPPORT = adaptDefinition(getLanguageById("vue"));
+export const SVELTE_SUPPORT = adaptDefinition(getLanguageById("svelte"));
+export const RUBY_SUPPORT = adaptDefinition(getLanguageById("ruby"));
+export const GO_SUPPORT = adaptDefinition(getLanguageById("go"));
+export const JAVA_SUPPORT = adaptDefinition(getLanguageById("java"));
+export const CSHARP_SUPPORT = adaptDefinition(getLanguageById("csharp"));
+export const RUST_SUPPORT = adaptDefinition(getLanguageById("rust"));
+export const C_SUPPORT = adaptDefinition(getLanguageById("c"));
+export const CPP_SUPPORT = adaptDefinition(getLanguageById("cpp"));
+export const KOTLIN_SUPPORT = adaptDefinition(getLanguageById("kotlin"));
+export const SWIFT_SUPPORT = adaptDefinition(getLanguageById("swift"));
+export const ZIG_SUPPORT = adaptDefinition(getLanguageById("zig"));
+export const SQL_SUPPORT = adaptDefinition(getLanguageById("sql"));
+export const LANGUAGE_SUPPORTS = getAllLanguages().map(adaptDefinition);
+const LANGUAGE_EXTENSION_KEY_PATTERN = /^\.[a-z0-9][a-z0-9._+-]*$/;
+const NON_REMAPPABLE_EXTENSIONS = new Set([".vue", ".svelte"]);
+export function isLiteralLanguageExtension(extension) {
+    return LANGUAGE_EXTENSION_KEY_PATTERN.test(extension.trim().toLowerCase());
+}
+export function isRemappableLanguageExtension(extension) {
+    return !NON_REMAPPABLE_EXTENSIONS.has(extension.trim().toLowerCase());
+}
+export function normalizeLanguageExtensions(extensions) {
+    const entries = Object.entries(extensions ?? {})
+        .map(([extension, languageId]) => [extension.trim().toLowerCase(), languageId.trim().toLowerCase()])
+        .filter(([extension, languageId]) => isLiteralLanguageExtension(extension) && isRemappableLanguageExtension(extension) && !!supportById(languageId))
+        .sort((left, right) => left[0].localeCompare(right[0]));
+    if (!entries.length)
+        return undefined;
+    return Object.fromEntries(entries);
+}
+function caseInsensitiveExtensionPattern(extension) {
+    const suffix = extension.replace(/[a-z]/g, (letter) => `[${letter}${letter.toUpperCase()}]`);
+    return `**/*${suffix}`;
+}
+export function languageExtensionPatterns(extensions) {
+    return Object.keys(normalizeLanguageExtensions(extensions) ?? {}).map(caseInsensitiveExtensionPattern);
+}
+function mappedSupportForFile(filename, extensionMap) {
+    const mappings = Object.entries(normalizeLanguageExtensions(extensionMap) ?? {}).sort((left, right) => right[0].length - left[0].length || left[0].localeCompare(right[0]));
+    const lowerFilename = filename.toLowerCase();
+    for (const [extension, languageId] of mappings) {
+        if (!lowerFilename.endsWith(extension))
+            continue;
+        return supportById(languageId);
+    }
+    return undefined;
+}
+export function supportForFile(filename, extensionMap) {
+    const mapped = extensionMap ? mappedSupportForFile(filename, extensionMap) : undefined;
+    if (mapped)
+        return mapped;
+    const ext = path.extname(filename).toLowerCase();
+    if (ext === ".h") {
+        const sample = readFileSample(filename);
+        if (sample && isLikelyCppHeader(sample))
+            return CPP_SUPPORT;
+        return C_SUPPORT;
+    }
+    return LANGUAGE_SUPPORTS.find((s) => s.matchExts.includes(ext));
+}
+export function languageForFile(filename, extensionMap) {
+    const sup = supportForFile(filename, extensionMap);
+    if (!sup)
+        throw new Error(`Unsupported file extension: ${filename}`);
+    return sup.language(filename);
+}
+export function supportById(id) {
+    return LANGUAGE_SUPPORTS.find((s) => s.id === id);
+}
+const HEADER_SAMPLE_SIZE = 8000;
+const CPP_HEADER_HINT = /\b(class|namespace|template|typename|constexpr|operator|using\s+namespace)\b|::/;
+function readFileSample(filePath) {
+    try {
+        const contents = fs.readFileSync(filePath, "utf8");
+        return contents.slice(0, HEADER_SAMPLE_SIZE);
+    }
+    catch {
+        return null;
+    }
+}
+function isLikelyCppHeader(sample) {
+    return CPP_HEADER_HINT.test(sample);
+}
+//# sourceMappingURL=languages.js.map

package/dist/languages.js.map

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

package/dist/lifecycle/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class CodegraphLifecycleUserError extends Error {
+    name: string;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lifecycle/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lifecycle/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,SAAiC;CAC/C"}

package/dist/lifecycle/errors.js

@@ -0,0 +1,4 @@
+export class CodegraphLifecycleUserError extends Error {
+    name = "CodegraphLifecycleUserError";
+}
+//# sourceMappingURL=errors.js.map

package/dist/lifecycle/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lifecycle/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,IAAI,GAAG,6BAA6B,CAAC;CAC/C"}

package/dist/lifecycle/gitignore.d.ts

@@ -0,0 +1,10 @@
+export declare const CODEGRAPH_GITIGNORE_RULES: readonly [".codegraph/", ".codegraph-cache/"];
+export type CodegraphLifecycleGitignoreResult = {
+    status: "added" | "already-ignored" | "tracked" | "not-git" | "disabled";
+    path: ".gitignore";
+    rules?: string[];
+};
+export declare function prepareCodegraphLifecycleGitignore(root: string, options?: {
+    updateGitignore?: boolean;
+}): Promise<CodegraphLifecycleGitignoreResult>;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/lifecycle/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/lifecycle/gitignore.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,yBAAyB,+CAAiE,CAAC;AAExG,MAAM,MAAM,iCAAiC,GAAG;IAC9C,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACzE,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AA6CF,wBAAsB,kCAAkC,CACtD,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,OAAO,CAAC,iCAAiC,CAAC,CAiC5C"}

package/dist/lifecycle/gitignore.js

@@ -0,0 +1,83 @@
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { isGitPathIgnored, isGitPathTracked, isGitRepo } from "../util/git.js";
+import { errorMessage } from "../util/errors.js";
+import { CodegraphLifecycleUserError } from "./errors.js";
+const LIFECYCLE_MANIFEST_PATH = ".codegraph/manifest.json";
+const DISK_CACHE_PROBE_PATH = ".codegraph-cache/index-v1/manifest.json";
+const GITIGNORE_PATH = ".gitignore";
+const LIFECYCLE_GITIGNORE_RULE = ".codegraph/";
+const DISK_CACHE_GITIGNORE_RULE = ".codegraph-cache/";
+export const CODEGRAPH_GITIGNORE_RULES = [LIFECYCLE_GITIGNORE_RULE, DISK_CACHE_GITIGNORE_RULE];
+async function readGitignoreFile(gitignorePath) {
+    let existing = "";
+    let stats;
+    try {
+        stats = await fsp.lstat(gitignorePath);
+    }
+    catch (error) {
+        if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) {
+            const detail = errorMessage(error);
+            throw new CodegraphLifecycleUserError(`Unable to inspect ${gitignorePath}: ${detail}. Check the path and permissions or rerun with --no-update-gitignore.`);
+        }
+    }
+    if (stats) {
+        if (!stats.isFile()) {
+            let kind = "non-regular file";
+            if (stats.isDirectory())
+                kind = "directory";
+            if (stats.isSymbolicLink())
+                kind = "symbolic link";
+            throw new CodegraphLifecycleUserError(`Cannot update ${gitignorePath}: expected a regular file, but found a ${kind}. ` +
+                "Replace it with a regular file or rerun with --no-update-gitignore.");
+        }
+        try {
+            existing = await fsp.readFile(gitignorePath, "utf8");
+        }
+        catch (error) {
+            const detail = errorMessage(error);
+            throw new CodegraphLifecycleUserError(`Unable to read ${gitignorePath}: ${detail}. Check file permissions or rerun with --no-update-gitignore.`);
+        }
+    }
+    return {
+        existing,
+        ...(stats ? { stats } : {}),
+        newline: existing.includes("\r\n") ? "\r\n" : "\n",
+    };
+}
+export async function prepareCodegraphLifecycleGitignore(root, options = {}) {
+    const { updateGitignore = true } = options;
+    if (!updateGitignore)
+        return { status: "disabled", path: GITIGNORE_PATH };
+    const resolvedRoot = path.resolve(root);
+    if (!(await isGitRepo(resolvedRoot)))
+        return { status: "not-git", path: GITIGNORE_PATH };
+    const manifestTracked = await isGitPathTracked(resolvedRoot, LIFECYCLE_MANIFEST_PATH);
+    if (manifestTracked)
+        return { status: "tracked", path: GITIGNORE_PATH };
+    const [lifecycleIgnored, diskCacheIgnored] = await Promise.all([
+        isGitPathIgnored(resolvedRoot, LIFECYCLE_MANIFEST_PATH),
+        isGitPathIgnored(resolvedRoot, DISK_CACHE_PROBE_PATH),
+    ]);
+    const missingRules = [
+        ...(!lifecycleIgnored ? [LIFECYCLE_GITIGNORE_RULE] : []),
+        ...(!diskCacheIgnored ? [DISK_CACHE_GITIGNORE_RULE] : []),
+    ];
+    if (!missingRules.length) {
+        return { status: "already-ignored", path: GITIGNORE_PATH, rules: [...CODEGRAPH_GITIGNORE_RULES] };
+    }
+    const gitignorePath = path.join(resolvedRoot, GITIGNORE_PATH);
+    const { existing, newline } = await readGitignoreFile(gitignorePath);
+    let suffix = missingRules.map((rule) => `${rule}${newline}`).join("");
+    if (existing && !existing.endsWith("\n"))
+        suffix = `${newline}${suffix}`;
+    try {
+        await fsp.appendFile(gitignorePath, suffix, "utf8");
+    }
+    catch (error) {
+        const detail = errorMessage(error);
+        throw new CodegraphLifecycleUserError(`Unable to update ${gitignorePath}: ${detail}. Check file permissions or rerun with --no-update-gitignore.`);
+    }
+    return { status: "added", path: GITIGNORE_PATH, rules: missingRules };
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/lifecycle/gitignore.js.map

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

package/dist/lifecycle/manifest.d.ts

@@ -0,0 +1,73 @@
+import type { BuildOptions } from "../indexer/types.js";
+import type { AnalysisSummary } from "../analysisSummary.js";
+import { type CodegraphLifecycleGitignoreResult } from "./gitignore.js";
+export type CodegraphLifecycleManifest = {
+    schemaVersion: 1;
+    root: ".";
+    createdAt: string;
+    lastSyncAt: string;
+    configHash: string;
+    buildOptionsHash: string;
+    fileCount: number;
+    fileSignatureHash: string;
+    /** Sorted, root-relative file paths as of the last sync. Absent on manifests written before this field existed. */
+    files?: string[];
+    analysis: AnalysisSummary;
+};
+export type CodegraphLifecycleStatus = {
+    schemaVersion: 1;
+    root: string;
+    initialized: boolean;
+    manifestPath: string;
+    lastSyncAt?: string;
+    fileCount?: {
+        then: number;
+        current: number;
+    };
+    configChanged: boolean;
+    buildOptionsChanged: boolean;
+    filesChanged: boolean;
+    analysis?: AnalysisSummary;
+    suggestedNextCommand: string;
+};
+export type { CodegraphLifecycleGitignoreResult } from "./gitignore.js";
+export { CodegraphLifecycleUserError } from "./errors.js";
+export type CodegraphLifecycleSyncResult = {
+    schemaVersion: 1;
+    root: string;
+    initialized: true;
+    manifestPath: string;
+    manifest: CodegraphLifecycleManifest;
+    changedFiles: {
+        added: number;
+        removed: number;
+        totalDelta: number;
+    };
+    gitignore?: CodegraphLifecycleGitignoreResult;
+};
+export type CodegraphLifecycleUninitResult = {
+    schemaVersion: 1;
+    root: string;
+    removed: boolean;
+    manifestPath: string;
+};
+export declare function codegraphLifecycleManifestPath(root: string): string;
+export declare function initCodegraphLifecycle(root: string, options?: {
+    buildOptions?: BuildOptions;
+    force?: boolean;
+    updateGitignore?: boolean;
+}): Promise<CodegraphLifecycleSyncResult>;
+export declare function syncCodegraphLifecycle(root: string, options?: {
+    buildOptions?: BuildOptions;
+    init?: boolean;
+    force?: boolean;
+    updateGitignore?: boolean;
+}): Promise<CodegraphLifecycleSyncResult>;
+export declare function getCodegraphLifecycleStatus(root: string, options?: {
+    buildOptions?: BuildOptions;
+}): Promise<CodegraphLifecycleStatus>;
+export declare function uninitCodegraphLifecycle(root: string, options?: {
+    force?: boolean;
+}): Promise<CodegraphLifecycleUninitResult>;
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/lifecycle/manifest.d.ts.map

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