/**
 * Thin reader for .cleo/project-info.json.
 *
 * The file is written by scaffold.ts (ensureProjectInfo). This module
 * provides a typed read interface for consumers that need the project-local
 * identity fields without importing the full scaffold machinery.
 *
 * @task T5333
 * @task T11008 — resolveProjectByCwd and resolveCanonicalCleoDir added to @cleocode/paths
 */
import { type ProjectInfo } from './project-scope.js';
export { getProjectDisplayName } from './project-scope.js';
/**
 * Rewrite ONLY the `name` of a valid `.cleo/project.json` (T12716). The id and
 * `schemaVersion` are carried over, keys this build does not know are kept
 * (after the three known ones), and the write goes through a tmp file unique
 * to this call (`O_EXCL`), renamed into place — concurrent writers never share
 * a tmp path, and a crash never leaves a half-written identity file.
 *
 * @param projectRoot - Project root.
 * @param name - New display name; the caller validates it.
 * @returns The previous and new names and the (unchanged) id.
 * @throws {Error} When `project.json` is absent or not a valid manifest.
 * @example
 * ```ts
 * writeProjectManifestName('/repo', 'cleo-platform');
 * ```
 * @task T12716
 */
export declare function writeProjectManifestName(projectRoot: string, name: string): {
    oldName: string;
    newName: string;
    projectId: string;
};
export type { ProjectInfo } from './project-scope.js';
/**
 * Read project-info.json and return a typed ProjectInfo.
 *
 * Falls back gracefully when the project-local `projectId` is missing
 * (pre-T5333 installs) by returning an empty string, allowing callers to
 * detect and handle the legacy shape.
 *
 * @throws {Error} If .cleo/project-info.json does not exist or is invalid JSON.
 */
export declare function getProjectInfo(cwd?: string): Promise<ProjectInfo>;
/**
 * Synchronous variant for use in hot paths where async is not feasible.
 * Returns null if the file is missing or unparseable.
 */
export declare function getProjectInfoSync(cwd?: string): ProjectInfo | null;
/**
 * The project's write-once `projectHash` identity key.
 *
 * Every persisted key built from the hash (release ids `<hash>:<version>`,
 * audit rows, idempotency) MUST come from here, never from
 * `generateProjectHash(projectRoot)`: a path-derived hash changes when the
 * project moves and splits those keys (T12557).
 *
 * @param cwd - Project root (defaults to the resolved current project).
 * @returns The persisted hash, or {@link computeStableProjectHash} when the
 *   project has no readable `project-info.json` — the same value
 *   `ensureProjectInfo` records for any project it did not just mint (T12716).
 * @example
 * ```ts
 * const releaseId = `${getProjectHashKey(root)}:${version}`;
 * ```
 * @task T12557
 */
export declare function getProjectHashKey(cwd?: string): string;
/**
 * Update the project name, synchronously (T12716).
 *
 * Writes the committed `.cleo/project.json` `name` (id carried over
 * byte-identical) when the project has one; a legacy project without it gets
 * `project-info.json` `displayName`, which `getProjectDisplayName` reads. The
 * cached `name` is never touched: it is the frozen input to the path
 * fingerprint alias key. It once wrote `projectName`, which nothing reads; a
 * stray one is removed.
 *
 * Programmatic consumers that also want the registry and Nexus labels use
 * `renameProject` (`cleo project rename`, `cleo upgrade --name`).
 *
 * @param cwd - Project root.
 * @param name - New display name (trimmed; must pass `isValidProjectDisplayName`).
 * @throws {Error} When the name is invalid.
 */
export declare function updateProjectName(cwd: string, name: string): void;
//# sourceMappingURL=project-info.d.ts.map