@coggit/core 0.2.0

package/dist/project/workspace.d.ts

@@ -0,0 +1,5 @@
+import type { CoggitWorkspaceRoot } from '../types';
+import type { ConfigProvider, FileSystem, UriComponents, WorkspaceFolderInfo } from '../interfaces';
+import type { CoggitLogger } from '../logger';
+export declare function discoverWorkspaceRoots(fs: FileSystem, config: ConfigProvider, logger?: CoggitLogger): Promise<CoggitWorkspaceRoot[]>;
+export declare function readWorkspaceRoot(fs: FileSystem, workspaceFolder: WorkspaceFolderInfo, configUri: UriComponents, logger?: CoggitLogger): Promise<CoggitWorkspaceRoot | undefined>;

package/dist/projection.d.ts

@@ -0,0 +1,34 @@
+import type { CoggitSnapshot, CoggitTreeNode, TreeProjectionNode } from './types.js';
+/**
+ * Result of depth-limited tree projection.
+ * Nodes beyond the requested depth are stripped; truncation flags report how many.
+ */
+export interface TreeDepthResult<T> {
+    nodes: T[];
+    truncated: boolean;
+    omittedChildrenCount: number;
+}
+/**
+ * Generic tree depth limiter.
+ * Strips children beyond `depth` and reports truncation stats.
+ * Works on any tree-like structure where nodes have an optional `children` array.
+ */
+export declare function applyTreeDepth<T extends {
+    children?: T[];
+    truncated?: boolean;
+    omittedChildrenCount?: number;
+}>(nodes: T[], depth: number): TreeDepthResult<T>;
+export interface ProjectionOptions {
+    depth?: number;
+    scope?: 'tracked' | 'untracked' | 'issues' | 'all';
+}
+/**
+ * Project a single Coggit tree node (and its descendants) into TreeProjectionNode[].
+ * Applies depth limiting and scope filtering.
+ */
+export declare function projectTreeFromSnapshot(node: CoggitTreeNode, options?: ProjectionOptions): TreeProjectionNode[];
+/**
+ * Project all roots of a Coggit snapshot into TreeProjectionNode[].
+ * Applies depth limiting and scope filtering.
+ */
+export declare function projectSnapshotTree(snapshot: CoggitSnapshot, options?: ProjectionOptions): TreeProjectionNode[];

package/dist/public.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Public SDK surface for `@coggit/core`.
+ *
+ * This is the curated barrel exposed through the package `.` export. It
+ * intentionally omits the watch family (`calculateAffected`, `applyWatchEventToProjects`,
+ * `createWatchHost`, watch types) — v1 is reconcile-on-read and watch authority
+ * remains adapter-only — and adds the port contracts runtime adapters must
+ * implement against. `internal.ts` stays the full internal barrel (the
+ * `@coggit/core/internal` export for in-repo consumers).
+ */
+export { initProject } from './project';
+export { findProjectRoot } from './project';
+export { RuntimeAcceptanceEvidence, createCoggitServices, discoverCoggitProjects, openCoggitProject, buildSnapshotFromProjects, } from './project';
+export { projectContextFromRoot } from './project';
+export { noOpProjectLockManager, ProjectLockError, } from './locks';
+export { ADD_OPERATION_ERROR_CODES, CORE_OPERATION_IDS, addOperation, resolveOperation, routesOperation, findProjectNode, handbookCatalog, handbookIdForCognitionKind, handbookIdForNodeKind, operationIssue, projectContext, snapshotOperation, statusOperation, } from './operations';
+export type { AddOperationError, AddOperationErrorCode, AddOperationResult, ResolveErrorCode, ResolveOperationError, ResolveOperationResult, CoggitHandbookCatalogEntry, CoggitOperationAction, CoggitOperationIssue, CoggitProjectContext, CoreOperationId, RoutesOperationResult, SnapshotOperationResult, SnapshotOperationOptions, SnapshotOperationScope, SourcePathCandidatesExpander, StatusOperationOptions, StatusOperationResult, } from './operations';
+export type { CoggitProjectDiscoveryOptions, RegistryInitFailurePolicy, } from './project';
+export { getCognitionHandbook, getCognitionTemplate } from './cognition';
+export { getCoggitSystemPrompt, MINIMAL_SYSTEM_PROMPT } from './systemPrompt';
+export type { CoggitSystemPrompt, CoggitSystemPromptKind } from './systemPrompt';
+export { applyTreeDepth, projectSnapshotTree, projectTreeFromSnapshot, } from './projection';
+export { DEFAULT_ROUTES_DEPTH, assembleRoutesContent, countRouteNodes, flattenRoutesProjection, projectRoutesEntries, routeProjectionLineText, selectRoutesBySourcePath, toRoutesStructuredOutput, } from './routesProjection';
+export type { AssembleRoutesContentOptions, RoutesPresentationContent, RoutesPresentationFormat, RoutesStructuredOutput, } from './routesProjection';
+export { projectStatusAgentPresentation, renderStatusAgentInspectionText, renderStatusAgentPresentation, } from './status/statusAgentPresentation';
+export type { StatusAgentActionLegendEntry, StatusAgentActionRole, StatusAgentIssueLegendEntry, StatusAgentIssueRow, StatusAgentPresentation, StatusAgentSeverityLevel, } from './status/statusAgentPresentation';
+export { projectStatusMissPresentation, projectStatusPresentation, renderStatusPresentation, } from './status/statusPresentation';
+export type { StatusMissPresentation, StatusPresentationFormat, StatusPresentationIssue, StatusPresentationView, } from './status/statusPresentation';
+export { tryGetCognitionPath } from './status/lookupCognition';
+export type { CognitionLookupHit } from './status/lookupCognition';
+export { projectMaintenancePresentation, renderMaintenancePresentation, } from './maintenancePresentation';
+export type { MaintenanceIssueCode, MaintenancePresentationFormat, MaintenancePresentationItem, MaintenancePresentationView, } from './maintenancePresentation';
+export { projectStatusTriage } from './status/statusTriage';
+export type { StatusTriageEntry, StatusTriageView, } from './status/statusTriage';
+export { buildMappingIndex, } from './snapshot';
+export { detectMisplacedCognitionEntries, detectOrphanedCognitionEntries, detectStrayCognitionEntries, detectUnboundCognitionEntries, } from './maintenance';
+export { describeObservedStatus, aggregateNodeStatus, collectSubtreeIssues, computeRuntimeStatus, countSubtreeIssues, inspectNodeStatus, projectStatusResultToNodeStatus, querySubtreeIssues, summarizeRepresentativeMtime, } from './status';
+export { normalizeSourcePathInput, toCognitionFileUri, toCognitionFolderReadmeUri, toRelativeUriPath, } from './mapping';
+export { PATH_HINT_MESSAGE, PATH_MISS_MESSAGE, pathHintsTryText, pathMissMessage, renderPathMissText, suggestPathHints, } from './pathHints';
+export { externalPathFromString, uriRelativePath, } from './uri-utils';
+export { createEnvCoggitLogger, debugLog, errorLog, infoLog, logEvent, nullCoggitLogger, warnLog, } from './logger';
+export type { CoggitLogEvent, CoggitLogLevel, CoggitLogger, } from './logger';
+export type { AddCognitionKind, AddCognitionOptions, AddCognitionResult, CognitionHandbook, CognitionKind, CognitionTemplate, } from './cognition';
+export type { ProjectLockContext, ProjectLockManager, } from './locks';
+export type { CoggitSnapshot, CoggitTreeNode, CoggitWorkspaceRoot, CognitionDiscoveryEntry, CognitionCoveragePresence, LocatedStatusIssue, MaintenanceDiagnostic, MisplacedCognitionEntry, NodeStatusInspection, NodeStatusResult, NodeStatusTriageEntry, ObservedStatus, OrphanedCognitionEntry, SourceCandidateState, StrayCognitionEntry, UnboundCognitionEntry, } from './types';
+export { discoverWorkspaceRoots, readWorkspaceRoot } from './project';
+export { buildSnapshot } from './project';
+export type { UriComponents, UriKey, FileSystem, FileStat, WorkspaceFolderInfo, ConfigProvider, RegistryProviderFactory, AcceptanceStore, ResolveResult, CoggitServices, CoggitProject, SourcePathResolution, } from './interfaces';
+export type { RegistryProvider, RegistryFile, AcceptedPair, CognitionRoutes, } from './types';
+export type { BuildCognitionRoutesOptions } from './cognitionRoutes';