feat: extract @nadle/project package from nadle core (#538)

Create @nadle/project (Layer 2) with project discovery, workspace
scanning, and dependency resolution extracted from nadle core.
Refactor nadle core to import from the new package.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: nam-hle

.github/workflows/ci.yml

@@ -63,6 +63,7 @@ jobs:
           name: build-output
           path: |
             packages/kernel/lib
+            packages/project/lib
             packages/nadle/lib
             packages/eslint-plugin/lib
             packages/create-nadle/lib
@@ -111,6 +112,9 @@ jobs:
       - name: Test kernel
         run: pnpm -F @nadle/kernel exec vitest run
 
+      - name: Test project
+        run: pnpm -F @nadle/project exec vitest run
+
       - name: Test nadle
         run: pnpm -F nadle exec vitest run
 

packages/nadle/knip.json

@@ -2,5 +2,5 @@
 	"$schema": "https://unpkg.com/knip@latest/schema.json",
 	"ignore": ["src/core/worker.ts", "src/core/file-logger.ts", "test/**", "nadle.config.ts"],
 	"ignoreBinaries": ["nadle"],
-	"ignoreDependencies": ["@nadle/kernel"]
+	"ignoreDependencies": ["@nadle/kernel", "@nadle/project"]
 }

packages/nadle/package.json

@@ -23,14 +23,12 @@
 	"bin": "nadle.mjs",
 	"types": "lib/index.d.ts",
 	"dependencies": {
-		"@manypkg/find-root": "^3.1.0",
-		"@manypkg/tools": "^2.1.0",
 		"@nadle/kernel": "workspace:*",
+		"@nadle/project": "workspace:*",
 		"consola": "^3.4.2",
 		"execa": "^9.6.1",
 		"fast-glob": "^3.3.3",
 		"fastest-levenshtein": "^1.0.16",
-		"find-up": "^8.0.0",
 		"fuzzysort": "^3.1.0",
 		"glob": "^11.1.0",
 		"ink": "^6.5.1",

packages/nadle/src/core/engine/worker.ts

@@ -2,10 +2,10 @@ import Path from "node:path";
 import WorkerThreads from "node:worker_threads";
 
 import c from "tinyrainbow";
+import { getWorkspaceById } from "@nadle/project";
 
 import { Nadle } from "../nadle.js";
 import { bindObject } from "../utilities/utils.js";
-import { Project } from "../models/project/project.js";
 import { type RunnerContext } from "../interfaces/task.js";
 import { CacheValidator } from "../caching/cache-validator.js";
 import { type NadleResolvedOptions } from "../options/types.js";
@@ -40,7 +40,7 @@ export default async ({ port, taskId, options, env: originalEnv }: WorkerParams)
 	const nadle = await getOrCreateNadle(options);
 	const task = nadle.taskRegistry.getTaskById(taskId);
 	const taskConfig = task.configResolver();
-	const workspace = Project.getWorkspaceById(options.project, task.workspaceId);
+	const workspace = getWorkspaceById(options.project, task.workspaceId);
 	const workingDir = Path.resolve(workspace.absolutePath, taskConfig.workingDir ?? "");
 
 	const context: RunnerContext = {
@@ -68,7 +68,7 @@ interface CacheValidatorParams {
 
 function createCacheValidator(nadle: Nadle, params: CacheValidatorParams) {
 	const rootConfigFile = nadle.options.project.rootWorkspace.configFilePath;
-	const workspace = Project.getWorkspaceById(nadle.options.project, params.workspaceId);
+	const workspace = getWorkspaceById(nadle.options.project, params.workspaceId);
 	const configFiles = workspace.configFilePath ? [rootConfigFile, workspace.configFilePath] : [rootConfigFile];
 
 	return new CacheValidator(params.taskId, params.taskConfig, {

packages/nadle/src/core/handlers/list-handler.ts

@@ -1,11 +1,11 @@
 import c from "tinyrainbow";
 import { groupBy } from "lodash-es";
+import { isRootWorkspaceId } from "@nadle/project";
 
 import { BaseHandler } from "./base-handler.js";
 import { DASH } from "../utilities/constants.js";
 import { capitalize } from "../utilities/utils.js";
 import { combineComparators } from "../utilities/comparator.js";
-import { RootWorkspace } from "../models/project/root-workspace.js";
 import type { RegisteredTask } from "../interfaces/registered-task.js";
 
 interface DescribedTask extends RegisteredTask {
@@ -69,7 +69,7 @@ export class ListHandler extends BaseHandler {
 		]);
 
 		const taskComparator = combineComparators<DescribedTask>([
-			(a, b) => Number(RootWorkspace.isRootWorkspaceId(b.workspaceId)) - Number(RootWorkspace.isRootWorkspaceId(a.workspaceId)),
+			(a, b) => Number(isRootWorkspaceId(b.workspaceId)) - Number(isRootWorkspaceId(a.workspaceId)),
 			(a, b) => a.label.localeCompare(b.label)
 		]);
 

packages/nadle/src/core/handlers/list-workspace-handler.ts

@@ -1,12 +1,10 @@
 import c from "tinyrainbow";
+import { type Workspace, getAllWorkspaces, isRootWorkspaceId } from "@nadle/project";
 
 import { BaseHandler } from "./base-handler.js";
 import { highlight } from "../utilities/utils.js";
-import { Project } from "../models/project/project.js";
 import { createTree } from "../utilities/create-tree.js";
 import { StringBuilder } from "../utilities/string-builder.js";
-import { type Workspace } from "../models/project/workspace.js";
-import { RootWorkspace } from "../models/project/root-workspace.js";
 
 export class ListWorkspacesHandler extends BaseHandler {
 	public readonly name = "listWorkspaces";
@@ -17,7 +15,7 @@ export class ListWorkspacesHandler extends BaseHandler {
 	}
 
 	public handle() {
-		const workspaces = Project.getAllWorkspaces(this.context.options.project);
+		const workspaces = getAllWorkspaces(this.context.options.project);
 
 		const parentWorkspaceMap = this.computeParentWorkspaceMap(workspaces);
 		const childrenWorkspaceMap = Object.fromEntries(
@@ -31,7 +29,7 @@ export class ListWorkspacesHandler extends BaseHandler {
 			(workspace) => childrenWorkspaceMap[workspace.id],
 			(workspace) =>
 				new StringBuilder()
-					.add(RootWorkspace.isInstance(workspace) ? "Root workspace" : "Workspace")
+					.add(isRootWorkspaceId(workspace.id) ? "Root workspace" : "Workspace")
 					.add(highlight(workspace.id))
 					.addIf(workspace.label !== workspace.id && workspace.label !== "", c.dim(`(alias: ${workspace.label})`))
 					.build()
@@ -44,7 +42,7 @@ export class ListWorkspacesHandler extends BaseHandler {
 		const parentWorkspaceMap: Record<string, Workspace | null> = {};
 
 		for (const childWorkspace of workspaces) {
-			if (RootWorkspace.isInstance(childWorkspace)) {
+			if (isRootWorkspaceId(childWorkspace.id)) {
 				parentWorkspaceMap[childWorkspace.id] = null;
 				continue;
 			}
@@ -68,7 +66,7 @@ export class ListWorkspacesHandler extends BaseHandler {
 	}
 
 	private isParentWorkspace(parentWorkspace: Workspace, childWorkspace: Workspace): boolean {
-		if (RootWorkspace.isInstance(parentWorkspace)) {
+		if (isRootWorkspaceId(parentWorkspace.id)) {
 			return true;
 		}
 

packages/nadle/src/core/interfaces/defaults/default-file-reader.ts

@@ -1,9 +1,9 @@
 import Url from "node:url";
 
 import { createJiti } from "jiti";
+import { SUPPORT_EXTENSIONS } from "@nadle/project";
 
 import { type FileReader } from "../file-reader.js";
-import { SUPPORT_EXTENSIONS } from "../../utilities/constants.js";
 
 export class DefaultFileReader implements FileReader {
 	private readonly reader = createJiti(import.meta.url, {