@baseplate-dev/project-builder-server 0.5.3 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # @baseplate-dev/project-builder-server
 
+## 0.6.1
+
+### Patch Changes
+
+- [#806](https://github.com/halfdomelabs/baseplate/pull/806) [`0b973f3`](https://github.com/halfdomelabs/baseplate/commit/0b973f3b9cb03fa1c49ceb49839b210466ecbbc7) Thanks [@kingston](https://github.com/kingston)! - Add bypass roles support to query filters for global role handling
+
+- Updated dependencies [[`c371612`](https://github.com/halfdomelabs/baseplate/commit/c37161281c660a799a2a74537cd751fd58f3b05f), [`0b973f3`](https://github.com/halfdomelabs/baseplate/commit/0b973f3b9cb03fa1c49ceb49839b210466ecbbc7)]:
+  - @baseplate-dev/fastify-generators@0.6.1
+  - @baseplate-dev/core-generators@0.6.1
+  - @baseplate-dev/project-builder-lib@0.6.1
+  - @baseplate-dev/react-generators@0.6.1
+  - @baseplate-dev/sync@0.6.1
+  - @baseplate-dev/utils@0.6.1
+
+## 0.6.0
+
+### Patch Changes
+
+- [#783](https://github.com/halfdomelabs/baseplate/pull/783) [`bd1095e`](https://github.com/halfdomelabs/baseplate/commit/bd1095e52dc3cecdb40bf84a906490a7c92fec40) Thanks [@kingston](https://github.com/kingston)! - Add offset pagination (skip/take) to list queries and optional count query generation
+
+- [#782](https://github.com/halfdomelabs/baseplate/pull/782) [`a136dc9`](https://github.com/halfdomelabs/baseplate/commit/a136dc90ba12783e059fd3c8a067d1b5496ed3ce) Thanks [@kingston](https://github.com/kingston)! - Extract developer tooling into new `@baseplate-dev/project-builder-dev` package with `baseplate-dev` binary.
+  - `project-builder-dev` includes: `templates`, `snapshot`, `dev-server`, `sync-examples` commands, plus full MCP server (all actions)
+  - `project-builder-cli` retains end-user commands only: `sync`, `diff`, `serve`, `config`, `projects`, and a user-scoped MCP server (sync/diff actions only)
+  - `project-builder-server` exports new `USER_SERVICE_ACTIONS` for the subset of actions exposed to end-users via MCP
+  - Plugins auto-discovered from CWD's `package.json` — no `project-builder-common` dependency in `project-builder-dev`
+  - `generateProject(dir)` exported from `project-builder-dev` for programmatic project generation in tests
+
+- [#802](https://github.com/halfdomelabs/baseplate/pull/802) [`801c706`](https://github.com/halfdomelabs/baseplate/commit/801c7066f7e943c026f03e71b8d39242036e0cad) Thanks [@kingston](https://github.com/kingston)! - Update prettier to ignore unchanged files in output
+
+- [#802](https://github.com/halfdomelabs/baseplate/pull/802) [`801c706`](https://github.com/halfdomelabs/baseplate/commit/801c7066f7e943c026f03e71b8d39242036e0cad) Thanks [@kingston](https://github.com/kingston)! - Add `isAuthenticated` boolean to authorizer expression DSL and AuthContext. Warn when `hasRole('user')` is used, suggesting `isAuthenticated` instead.
+
+- [#798](https://github.com/halfdomelabs/baseplate/pull/798) [`ee7ee0e`](https://github.com/halfdomelabs/baseplate/commit/ee7ee0e552090612190eb4446a52c30f4eefce6a) Thanks [@kingston](https://github.com/kingston)! - Add MCP actions for reading and writing project definition entities, including draft session support for staging changes before committing.
+
+- [#802](https://github.com/halfdomelabs/baseplate/pull/802) [`801c706`](https://github.com/halfdomelabs/baseplate/commit/801c7066f7e943c026f03e71b8d39242036e0cad) Thanks [@kingston](https://github.com/kingston)! - Add nested authorizer expressions: `hasRole(model.relation, 'role')` and `hasSomeRole(model.relation, ['role1', 'role2'])` for checking roles on related model authorizers, with autocomplete and linter support.
+
+- [#777](https://github.com/halfdomelabs/baseplate/pull/777) [`dc238be`](https://github.com/halfdomelabs/baseplate/commit/dc238be00158a528a60d9e6ef9cec32b2d8297be) Thanks [@kingston](https://github.com/kingston)! - Add per-field authorization support for GraphQL object type fields
+
+- [#796](https://github.com/halfdomelabs/baseplate/pull/796) [`8258b27`](https://github.com/halfdomelabs/baseplate/commit/8258b278e9a25a6e4bd5039a134238d071a63ecd) Thanks [@kingston](https://github.com/kingston)! - Add query filter code generation for instance-level authorization on GraphQL queries
+
+- [#793](https://github.com/halfdomelabs/baseplate/pull/793) [`6e2675d`](https://github.com/halfdomelabs/baseplate/commit/6e2675d2166ac9bf470486efdc6a0e48df9bcc6d) Thanks [@kingston](https://github.com/kingston)! - Move mutation authorization from GraphQL-level to service-level, add compact grid-based role picker UI, filter system role from auth pickers, and hide disabled service methods from GraphQL mutations section
+
+- [#789](https://github.com/halfdomelabs/baseplate/pull/789) [`2f860c5`](https://github.com/halfdomelabs/baseplate/commit/2f860c513a1caf95fdfd0729cf548990166f9a6f) Thanks [@kingston](https://github.com/kingston)! - Unify test and example project discovery under a single system:
+  - Add `type: 'user' | 'example' | 'test'` and `baseplateDirectory` to `ProjectInfo`, replacing `isInternalExample`.
+  - Add `baseplate.config.json` for deterministic project discovery — replaces `isExampleProject` heuristic and `EXCLUDE_EXAMPLES`/`PLUGIN_ROOT_DIRECTORIES` env vars.
+  - Unify `discoverProjects` to accept structured options by project type — removes `discoverTestProjects` and duplicate `project-resolver.ts`.
+  - Test projects live in `tests/<name>/` with output to `.output/` (gitignored).
+  - Replace `test-project` subcommands with `baseplate-dev init <name> --type example|test` and `baseplate-dev run-env <test-name>`.
+
+- [#800](https://github.com/halfdomelabs/baseplate/pull/800) [`83c713b`](https://github.com/halfdomelabs/baseplate/commit/83c713b075eca2abc946e74bf3f03e515e601eba) Thanks [@kingston](https://github.com/kingston)! - Upgrade fastify and related packages
+  - fastify: 5.7.4 → 5.8.1 (includes security fix CVE-2026-3419)
+  - @fastify/helmet: 13.0.0 → 13.0.2
+  - @fastify/websocket: 11.0.1 → 11.2.0
+  - @fastify/request-context: 6.0.1 → 6.2.1
+  - @fastify/formbody: 8.0.1 → 8.0.2
+  - @fastify/cookie: 11.0.1 → 11.0.2
+  - altair-fastify-plugin: 8.0.4 → 8.5.1
+
+- [#785](https://github.com/halfdomelabs/baseplate/pull/785) [`bd25ff0`](https://github.com/halfdomelabs/baseplate/commit/bd25ff08e71faeb97b560e7b349dba1967155704) Thanks [@kingston](https://github.com/kingston)! - Remove redundant `.optional()` wrapper from `withDefault`
+
+  `withDefault` previously wrapped the schema in both `.prefault()` and `.optional()`. Since `.prefault()` already makes fields accept absent/undefined input, the `.optional()` was redundant and caused the output type to incorrectly include `| undefined` for defaulted fields.
+
+- Updated dependencies [[`ee7ee0e`](https://github.com/halfdomelabs/baseplate/commit/ee7ee0e552090612190eb4446a52c30f4eefce6a), [`bd1095e`](https://github.com/halfdomelabs/baseplate/commit/bd1095e52dc3cecdb40bf84a906490a7c92fec40), [`801c706`](https://github.com/halfdomelabs/baseplate/commit/801c7066f7e943c026f03e71b8d39242036e0cad), [`1225fda`](https://github.com/halfdomelabs/baseplate/commit/1225fdace3e8da20152e0e78c4decf0c063faa56), [`3029d42`](https://github.com/halfdomelabs/baseplate/commit/3029d42f5d5967721f2b0d5892ea07a80c5f3a1f), [`dfa9638`](https://github.com/halfdomelabs/baseplate/commit/dfa963825c4ba847f9d21f4f014c4dd1722403d6), [`d6be7a9`](https://github.com/halfdomelabs/baseplate/commit/d6be7a97b5e6970be674bf9b49eddf1499b51f04), [`3b3be2b`](https://github.com/halfdomelabs/baseplate/commit/3b3be2b8d45b08552dca3d4e2b5ce391a958341b), [`eadad84`](https://github.com/halfdomelabs/baseplate/commit/eadad8494128ded2cbc76dfbe3b97f93769ea41f), [`801c706`](https://github.com/halfdomelabs/baseplate/commit/801c7066f7e943c026f03e71b8d39242036e0cad), [`ee7ee0e`](https://github.com/halfdomelabs/baseplate/commit/ee7ee0e552090612190eb4446a52c30f4eefce6a), [`801c706`](https://github.com/halfdomelabs/baseplate/commit/801c7066f7e943c026f03e71b8d39242036e0cad), [`dc238be`](https://github.com/halfdomelabs/baseplate/commit/dc238be00158a528a60d9e6ef9cec32b2d8297be), [`bd25ff0`](https://github.com/halfdomelabs/baseplate/commit/bd25ff08e71faeb97b560e7b349dba1967155704), [`8258b27`](https://github.com/halfdomelabs/baseplate/commit/8258b278e9a25a6e4bd5039a134238d071a63ecd), [`6e2675d`](https://github.com/halfdomelabs/baseplate/commit/6e2675d2166ac9bf470486efdc6a0e48df9bcc6d), [`634f6c5`](https://github.com/halfdomelabs/baseplate/commit/634f6c5aaffab982a985be9f85062de9d1e8a99b), [`2f860c5`](https://github.com/halfdomelabs/baseplate/commit/2f860c513a1caf95fdfd0729cf548990166f9a6f), [`cad5352`](https://github.com/halfdomelabs/baseplate/commit/cad535239b47080e30f894383cc330e37213a76c), [`83c713b`](https://github.com/halfdomelabs/baseplate/commit/83c713b075eca2abc946e74bf3f03e515e601eba), [`78315cc`](https://github.com/halfdomelabs/baseplate/commit/78315ccd9b0b0330cd2d08584c6d5ec516d641e3), [`2104145`](https://github.com/halfdomelabs/baseplate/commit/210414588d8b1f6816c45054be3b7eea5763b5ce), [`bd25ff0`](https://github.com/halfdomelabs/baseplate/commit/bd25ff08e71faeb97b560e7b349dba1967155704), [`cad5352`](https://github.com/halfdomelabs/baseplate/commit/cad535239b47080e30f894383cc330e37213a76c)]:
+  - @baseplate-dev/utils@0.6.0
+  - @baseplate-dev/project-builder-lib@0.6.0
+  - @baseplate-dev/fastify-generators@0.6.0
+  - @baseplate-dev/react-generators@0.6.0
+  - @baseplate-dev/core-generators@0.6.0
+  - @baseplate-dev/sync@0.6.0
+
 ## 0.5.3
 
 ### Patch Changes

package/dist/actions/__tests__/action-test-utils.d.ts

@@ -0,0 +1,24 @@
+import type { ProjectDefinitionInput, SchemaParserContext } from '@baseplate-dev/project-builder-lib';
+import type { ServiceActionContext } from '#src/actions/types.js';
+import type { EntityServiceContextResult } from '../definition/load-entity-service-context.js';
+/**
+ * Creates a minimal ServiceActionContext for testing.
+ *
+ * @param overrides - Partial overrides for context properties.
+ * @returns A ServiceActionContext with sensible test defaults.
+ */
+export declare function createTestActionContext(overrides?: Partial<ServiceActionContext>): ServiceActionContext;
+/**
+ * Creates a test EntityServiceContext from a partial project definition input.
+ *
+ * Uses `createTestProjectDefinitionContainer` to build the container in-memory,
+ * then converts it to an EntityServiceContext. No file I/O required.
+ *
+ * @param input - Partial ProjectDefinitionInput to customise the test definition.
+ * @returns An EntityServiceContextResult matching the shape returned by `loadEntityServiceContext`.
+ */
+export interface TestEntityServiceContextResult extends EntityServiceContextResult {
+    parserContext: SchemaParserContext;
+}
+export declare function createTestEntityServiceContext(input?: Partial<ProjectDefinitionInput>): TestEntityServiceContextResult;
+//# sourceMappingURL=action-test-utils.d.ts.map

package/dist/actions/__tests__/action-test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-test-utils.d.ts","sourceRoot":"","sources":["../../../src/actions/__tests__/action-test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAK5C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAE/F;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC5C,oBAAoB,CAkBtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,8BAA+B,SAAQ,0BAA0B;IAChF,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC1C,8BAA8B,CAIhC"}

package/dist/actions/__tests__/action-test-utils.js

@@ -0,0 +1,33 @@
+import { createTestProjectDefinitionContainer } from '@baseplate-dev/project-builder-lib/testing';
+import { createConsoleLogger } from '@baseplate-dev/sync';
+/**
+ * Creates a minimal ServiceActionContext for testing.
+ *
+ * @param overrides - Partial overrides for context properties.
+ * @returns A ServiceActionContext with sensible test defaults.
+ */
+export function createTestActionContext(overrides = {}) {
+    return {
+        projects: [
+            {
+                id: 'test-project',
+                name: 'test-project',
+                directory: '/test-project',
+                baseplateDirectory: '/test-project/baseplate',
+                type: 'user',
+            },
+        ],
+        plugins: [],
+        userConfig: {},
+        logger: createConsoleLogger('warn'),
+        cliVersion: '0.0.0-test',
+        sessionId: 'default',
+        ...overrides,
+    };
+}
+export function createTestEntityServiceContext(input = {}) {
+    const container = createTestProjectDefinitionContainer(input);
+    const entityContext = container.toEntityServiceContext();
+    return { entityContext, container, parserContext: container.parserContext };
+}
+//# sourceMappingURL=action-test-utils.js.map

package/dist/actions/__tests__/action-test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-test-utils.js","sourceRoot":"","sources":["../../../src/actions/__tests__/action-test-utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAM1D;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAA2C,EAAE;IAE7C,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,EAAE,EAAE,cAAc;gBAClB,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE,eAAe;gBAC1B,kBAAkB,EAAE,yBAAyB;gBAC7C,IAAI,EAAE,MAAM;aACb;SACF;QACD,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,EAAE;QACd,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC;QACnC,UAAU,EAAE,YAAY;QACxB,SAAS,EAAE,SAAS;QACpB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAeD,MAAM,UAAU,8BAA8B,CAC5C,QAAyC,EAAE;IAE3C,MAAM,SAAS,GAAG,oCAAoC,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,aAAa,GAAG,SAAS,CAAC,sBAAsB,EAAE,CAAC;IACzD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC;AAC9E,CAAC"}

package/dist/actions/definition/commit-draft.action.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export declare const commitDraftAction: import("#src/actions/types.js").ServiceAction<z.ZodObject<{
+    project: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    message: z.ZodString;
+    issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        message: z.ZodString;
+        entityId: z.ZodOptional<z.ZodString>;
+        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=commit-draft.action.d.ts.map

package/dist/actions/definition/commit-draft.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-draft.action.d.ts","sourceRoot":"","sources":["../../../src/actions/definition/commit-draft.action.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;kBAkE5B,CAAC"}

package/dist/actions/definition/commit-draft.action.js

@@ -0,0 +1,65 @@
+import { collectDefinitionIssues, ProjectDefinitionContainer, } from '@baseplate-dev/project-builder-lib';
+import { writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { createServiceAction } from '#src/actions/types.js';
+import { resolveBaseplateDir } from '#src/diff/snapshot/snapshot-utils.js';
+import { createNodeSchemaParserContext } from '#src/plugins/node-plugin-store.js';
+import { getProjectByNameOrId } from '../utils/projects.js';
+import { deleteDraftSession, loadDefinitionHash, loadDraftSession, } from './draft-session.js';
+import { definitionIssueSchema } from './validate-draft.js';
+const commitDraftInputSchema = z.object({
+    project: z.string().describe('The name or ID of the project.'),
+});
+const commitDraftOutputSchema = z.object({
+    message: z.string().describe('A summary of the commit result.'),
+    issues: z
+        .array(definitionIssueSchema)
+        .optional()
+        .describe('Definition issues that blocked the commit.'),
+});
+export const commitDraftAction = createServiceAction({
+    name: 'commit-draft',
+    title: 'Commit Draft',
+    description: 'Commit the staged draft changes to the project-definition.json file.',
+    inputSchema: commitDraftInputSchema,
+    outputSchema: commitDraftOutputSchema,
+    handler: async (input, context) => {
+        const project = getProjectByNameOrId(context.projects, input.project);
+        const session = await loadDraftSession(project.directory);
+        if (!session) {
+            throw new Error('No draft session found. Stage changes first with stage-create-entity, stage-update-entity, or stage-delete-entity.');
+        }
+        // Verify the definition hasn't changed since the draft was created
+        const currentHash = await loadDefinitionHash(project.directory);
+        if (currentHash !== session.definitionHash) {
+            throw new Error('The project definition has changed since the draft was created. ' +
+                'Discard the draft with discard-draft and start over.');
+        }
+        // Convert the serialized draft back to a proper definition and serialize it
+        const parserContext = await createNodeSchemaParserContext(project, context.logger, context.plugins, context.cliVersion);
+        const container = ProjectDefinitionContainer.fromSerializedConfig(session.draftDefinition, parserContext);
+        // Validate the draft definition before committing
+        const issues = collectDefinitionIssues(container);
+        if (issues.length > 0) {
+            const messages = issues
+                .map((i) => `[${i.severity}] ${i.message}`)
+                .join('; ');
+            throw new Error(`Commit blocked by definition issues: ${messages}`);
+        }
+        const serializedContents = container.toSerializedContents();
+        // Write to project-definition.json
+        const baseplateDir = resolveBaseplateDir(project.directory);
+        const projectJsonPath = path.join(baseplateDir, 'project-definition.json');
+        await writeFile(projectJsonPath, serializedContents, 'utf-8');
+        // Clean up draft session
+        await deleteDraftSession(project.directory);
+        return {
+            message: 'Draft committed successfully to project-definition.json.',
+        };
+    },
+    writeCliOutput: (output) => {
+        console.info(`✓ ${output.message}`);
+    },
+});
+//# sourceMappingURL=commit-draft.action.js.map

package/dist/actions/definition/commit-draft.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-draft.action.js","sourceRoot":"","sources":["../../../src/actions/definition/commit-draft.action.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC/D,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,qBAAqB,CAAC;SAC5B,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;IACnD,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,cAAc;IACrB,WAAW,EACT,sEAAsE;IACxE,WAAW,EAAE,sBAAsB;IACnC,YAAY,EAAE,uBAAuB;IACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,oHAAoH,CACrH,CAAC;QACJ,CAAC;QAED,mEAAmE;QACnE,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,WAAW,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,kEAAkE;gBAChE,sDAAsD,CACzD,CAAC;QACJ,CAAC;QAED,4EAA4E;QAC5E,MAAM,aAAa,GAAG,MAAM,6BAA6B,CACvD,OAAO,EACP,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,UAAU,CACnB,CAAC;QAEF,MAAM,SAAS,GAAG,0BAA0B,CAAC,oBAAoB,CAC/D,OAAO,CAAC,eAAe,EACvB,aAAa,CACd,CAAC;QAEF,kDAAkD;QAClD,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;QAElD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,MAAM;iBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC1C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,kBAAkB,GAAG,SAAS,CAAC,oBAAoB,EAAE,CAAC;QAE5D,mCAAmC;QACnC,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;QAC3E,MAAM,SAAS,CAAC,eAAe,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAE9D,yBAAyB;QACzB,MAAM,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE5C,OAAO;YACL,OAAO,EAAE,0DAA0D;SACpE,CAAC;IACJ,CAAC;IACD,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE;QACzB,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;CACF,CAAC,CAAC"}

package/dist/actions/definition/discard-draft.action.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const discardDraftAction: import("#src/actions/types.js").ServiceAction<z.ZodObject<{
+    project: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strip>>;
+//# sourceMappingURL=discard-draft.action.d.ts.map

package/dist/actions/definition/discard-draft.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discard-draft.action.d.ts","sourceRoot":"","sources":["../../../src/actions/definition/discard-draft.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,kBAAkB;;;;kBAsB7B,CAAC"}

package/dist/actions/definition/discard-draft.action.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { createServiceAction } from '#src/actions/types.js';
+import { getProjectByNameOrId } from '../utils/projects.js';
+import { deleteDraftSession, loadDraftSession } from './draft-session.js';
+const discardDraftInputSchema = z.object({
+    project: z.string().describe('The name or ID of the project.'),
+});
+const discardDraftOutputSchema = z.object({
+    message: z.string().describe('A summary of the discard result.'),
+});
+export const discardDraftAction = createServiceAction({
+    name: 'discard-draft',
+    title: 'Discard Draft',
+    description: 'Discard the current draft session, removing all staged changes.',
+    inputSchema: discardDraftInputSchema,
+    outputSchema: discardDraftOutputSchema,
+    handler: async (input, context) => {
+        const project = getProjectByNameOrId(context.projects, input.project);
+        const session = await loadDraftSession(project.directory);
+        if (!session) {
+            return { message: 'No draft session to discard.' };
+        }
+        await deleteDraftSession(project.directory);
+        return { message: 'Draft session discarded.' };
+    },
+    writeCliOutput: (output) => {
+        console.info(`✓ ${output.message}`);
+    },
+});
+//# sourceMappingURL=discard-draft.action.js.map

package/dist/actions/definition/discard-draft.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discard-draft.action.js","sourceRoot":"","sources":["../../../src/actions/definition/discard-draft.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;IACpD,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,eAAe;IACtB,WAAW,EACT,iEAAiE;IACnE,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;QACrD,CAAC;QAED,MAAM,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE5C,OAAO,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACjD,CAAC;IACD,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE;QACzB,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;CACF,CAAC,CAAC"}

package/dist/actions/definition/draft-session.d.ts

@@ -0,0 +1,41 @@
+import type { EntityServiceContext, SchemaParserContext } from '@baseplate-dev/project-builder-lib';
+import { z } from 'zod';
+import type { ServiceActionContext } from '#src/actions/types.js';
+declare const draftSessionMetadataSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    definitionHash: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Metadata for a draft session, stored separately from the large definition payload.
+ */
+export type DraftSessionMetadata = z.infer<typeof draftSessionMetadataSchema>;
+/**
+ * A draft session holds staged entity changes before they are committed
+ * to the project-definition.json file.
+ */
+export interface DraftSession extends DraftSessionMetadata {
+    /** The modified serialized definition (with names, not IDs). */
+    draftDefinition: Record<string, unknown>;
+}
+export declare function loadDraftSession(projectDirectory: string): Promise<DraftSession | null>;
+export declare function saveDraftSession(projectDirectory: string, session: DraftSession): Promise<void>;
+export declare function deleteDraftSession(projectDirectory: string): Promise<void>;
+export interface DraftSessionContext {
+    session: DraftSession;
+    entityContext: EntityServiceContext;
+    parserContext: SchemaParserContext;
+    projectDirectory: string;
+}
+/**
+ * Gets the existing draft session or creates a new one from the current project definition.
+ *
+ * If a draft exists but the session ID or definition hash doesn't match, an error is thrown
+ * requiring the caller to discard the stale draft first.
+ */
+export declare function getOrCreateDraftSession(projectNameOrId: string, context: ServiceActionContext): Promise<DraftSessionContext>;
+/**
+ * Loads the definition hash for the given project directory.
+ */
+export declare function loadDefinitionHash(projectDirectory: string): Promise<string>;
+export {};
+//# sourceMappingURL=draft-session.d.ts.map

package/dist/actions/definition/draft-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-session.d.ts","sourceRoot":"","sources":["../../../src/actions/definition/draft-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAO5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQlE,QAAA,MAAM,0BAA0B;;;iBAK9B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAkBD,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAiB9B;AAED,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,kBAAkB,CACtC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,oBAAoB,CAAC;IACpC,aAAa,EAAE,mBAAmB,CAAC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAiE9B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAKjB"}

package/dist/actions/definition/draft-session.js

@@ -0,0 +1,117 @@
+import { ProjectDefinitionContainer } from '@baseplate-dev/project-builder-lib';
+import { hashWithSHA256, stringifyPrettyStable } from '@baseplate-dev/utils';
+import { fileExists, handleFileNotFoundError } from '@baseplate-dev/utils/node';
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { resolveBaseplateDir } from '#src/diff/snapshot/snapshot-utils.js';
+import { createNodeSchemaParserContext } from '#src/plugins/node-plugin-store.js';
+import { loadProjectDefinition } from '#src/project-definition/load-project-definition.js';
+import { getProjectByNameOrId } from '../utils/projects.js';
+const draftSessionMetadataSchema = z.object({
+    /** ID of the session that created this draft. */
+    sessionId: z.string(),
+    /** SHA-256 hash of the original project-definition.json when the draft was created. */
+    definitionHash: z.string(),
+});
+const DRAFT_SESSION_FILENAME = 'draft-session.json';
+const DRAFT_DEFINITION_FILENAME = 'draft-definition.json';
+function getDraftDir(projectDirectory) {
+    const baseplateDir = resolveBaseplateDir(projectDirectory);
+    return path.join(baseplateDir, '.build');
+}
+function getDraftSessionPath(projectDirectory) {
+    return path.join(getDraftDir(projectDirectory), DRAFT_SESSION_FILENAME);
+}
+function getDraftDefinitionPath(projectDirectory) {
+    return path.join(getDraftDir(projectDirectory), DRAFT_DEFINITION_FILENAME);
+}
+export async function loadDraftSession(projectDirectory) {
+    const sessionPath = getDraftSessionPath(projectDirectory);
+    if (!(await fileExists(sessionPath))) {
+        return null;
+    }
+    const [sessionContents, definitionContents] = await Promise.all([
+        readFile(sessionPath, 'utf-8'),
+        readFile(getDraftDefinitionPath(projectDirectory), 'utf-8'),
+    ]);
+    const metadata = draftSessionMetadataSchema.parse(JSON.parse(sessionContents));
+    const draftDefinition = JSON.parse(definitionContents);
+    return { ...metadata, draftDefinition };
+}
+export async function saveDraftSession(projectDirectory, session) {
+    const draftDir = getDraftDir(projectDirectory);
+    await mkdir(draftDir, { recursive: true });
+    const metadata = {
+        sessionId: session.sessionId,
+        definitionHash: session.definitionHash,
+    };
+    await Promise.all([
+        writeFile(getDraftSessionPath(projectDirectory), stringifyPrettyStable(metadata)),
+        writeFile(getDraftDefinitionPath(projectDirectory), stringifyPrettyStable(session.draftDefinition)),
+    ]);
+}
+export async function deleteDraftSession(projectDirectory) {
+    const sessionPath = getDraftSessionPath(projectDirectory);
+    const definitionPath = getDraftDefinitionPath(projectDirectory);
+    await Promise.all([
+        rm(sessionPath).catch(handleFileNotFoundError),
+        rm(definitionPath).catch(handleFileNotFoundError),
+    ]);
+}
+/**
+ * Gets the existing draft session or creates a new one from the current project definition.
+ *
+ * If a draft exists but the session ID or definition hash doesn't match, an error is thrown
+ * requiring the caller to discard the stale draft first.
+ */
+export async function getOrCreateDraftSession(projectNameOrId, context) {
+    const project = getProjectByNameOrId(context.projects, projectNameOrId);
+    const { sessionId } = context;
+    const parserContext = await createNodeSchemaParserContext(project, context.logger, context.plugins, context.cliVersion);
+    const { definition, hash } = await loadProjectDefinition(project.baseplateDirectory, parserContext);
+    const existingDraft = await loadDraftSession(project.directory);
+    if (existingDraft) {
+        if (existingDraft.sessionId !== sessionId) {
+            throw new Error(`A draft session exists from a different session (${existingDraft.sessionId}). ` +
+                'Discard it with discard-draft before starting a new one.');
+        }
+        if (existingDraft.definitionHash !== hash) {
+            throw new Error('The project definition has changed since the draft was created. ' +
+                'Discard the draft with discard-draft and start over.');
+        }
+        // Rebuild EntityServiceContext from the draft definition
+        const draftContainer = ProjectDefinitionContainer.fromSerializedConfig(existingDraft.draftDefinition, parserContext);
+        const entityContext = draftContainer.toEntityServiceContext();
+        return {
+            session: existingDraft,
+            entityContext,
+            parserContext,
+            projectDirectory: project.directory,
+        };
+    }
+    // Create a new draft from the current definition
+    const container = ProjectDefinitionContainer.fromSerializedConfig(definition, parserContext);
+    const entityContext = container.toEntityServiceContext();
+    const session = {
+        sessionId,
+        definitionHash: hash,
+        draftDefinition: entityContext.serializedDefinition,
+    };
+    return {
+        session,
+        entityContext,
+        parserContext,
+        projectDirectory: project.directory,
+    };
+}
+/**
+ * Loads the definition hash for the given project directory.
+ */
+export async function loadDefinitionHash(projectDirectory) {
+    const baseplateDir = resolveBaseplateDir(projectDirectory);
+    const projectJsonPath = path.join(baseplateDir, 'project-definition.json');
+    const contents = await readFile(projectJsonPath, 'utf-8');
+    return hashWithSHA256(contents);
+}
+//# sourceMappingURL=draft-session.js.map

package/dist/actions/definition/draft-session.js.map

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

package/dist/actions/definition/get-entity-schema.action.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const getEntitySchemaAction: import("#src/actions/types.js").ServiceAction<z.ZodObject<{
+    project: z.ZodString;
+    entityTypeName: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    entityTypeName: z.ZodString;
+    parentEntityTypeName: z.ZodNullable<z.ZodString>;
+    schema: z.ZodString;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-entity-schema.action.d.ts.map

package/dist/actions/definition/get-entity-schema.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-schema.action.d.ts","sourceRoot":"","sources":["../../../src/actions/definition/get-entity-schema.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,eAAO,MAAM,qBAAqB;;;;;;;kBAmChC,CAAC"}

package/dist/actions/definition/get-entity-schema.action.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { createAuxiliaryTypeStore, printNode, zodToTs } from 'zod-to-ts';
+import { createServiceAction } from '#src/actions/types.js';
+import { loadEntityServiceContext } from './load-entity-service-context.js';
+const getEntitySchemaInputSchema = z.object({
+    project: z.string().describe('The name or ID of the project.'),
+    entityTypeName: z
+        .string()
+        .describe('The entity type to get the schema for (e.g., "feature", "model", "model-scalar-field").'),
+});
+const getEntitySchemaOutputSchema = z.object({
+    entityTypeName: z.string().describe('The entity type name.'),
+    parentEntityTypeName: z
+        .string()
+        .nullable()
+        .describe('The parent entity type name, or null for top-level entities.'),
+    schema: z
+        .string()
+        .describe('The TypeScript type representation of this entity type.'),
+});
+export const getEntitySchemaAction = createServiceAction({
+    name: 'get-entity-schema',
+    title: 'Get Entity Schema',
+    description: 'Get the TypeScript type for a given entity type. Useful for understanding valid field shapes before creating or updating entities.',
+    inputSchema: getEntitySchemaInputSchema,
+    outputSchema: getEntitySchemaOutputSchema,
+    writeCliOutput: (output) => {
+        console.info(output.schema);
+    },
+    handler: async (input, context) => {
+        const { entityContext } = await loadEntityServiceContext(input.project, context);
+        const metadata = entityContext.entityTypeMap.get(input.entityTypeName);
+        if (!metadata) {
+            throw new Error(`Unknown entity type: "${input.entityTypeName}". Use list-entities with entityTypeName "*" to discover available types.`);
+        }
+        const { node } = zodToTs(metadata.elementSchema, {
+            auxiliaryTypeStore: createAuxiliaryTypeStore(),
+            unrepresentable: 'any',
+        });
+        const schemaText = printNode(node);
+        return {
+            entityTypeName: input.entityTypeName,
+            parentEntityTypeName: metadata.parentEntityTypeName ?? null,
+            schema: schemaText,
+        };
+    },
+});
+//# sourceMappingURL=get-entity-schema.action.js.map

package/dist/actions/definition/get-entity-schema.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-schema.action.js","sourceRoot":"","sources":["../../../src/actions/definition/get-entity-schema.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC9D,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,CACP,yFAAyF,CAC1F;CACJ,CAAC,CAAC;AAEH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC5D,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;IACvD,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,oIAAoI;IACtI,WAAW,EAAE,0BAA0B;IACvC,YAAY,EAAE,2BAA2B;IACzC,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,wBAAwB,CACtD,KAAK,CAAC,OAAO,EACb,OAAO,CACR,CAAC;QAEF,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,CAAC,cAAc,2EAA2E,CACzH,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE;YAC/C,kBAAkB,EAAE,wBAAwB,EAAE;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAEnC,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB,IAAI,IAAI;YAC3D,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/actions/definition/get-entity.action.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const getEntityAction: import("#src/actions/types.js").ServiceAction<z.ZodObject<{
+    project: z.ZodString;
+    entityId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    entity: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-entity.action.d.ts.map

package/dist/actions/definition/get-entity.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity.action.d.ts","sourceRoot":"","sources":["../../../src/actions/definition/get-entity.action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,eAAO,MAAM,eAAe;;;;;kBAwB1B,CAAC"}

package/dist/actions/definition/get-entity.action.js

@@ -0,0 +1,37 @@
+import { getEntity } from '@baseplate-dev/project-builder-lib';
+import { stringifyPrettyStable } from '@baseplate-dev/utils';
+import { z } from 'zod';
+import { createServiceAction } from '#src/actions/types.js';
+import { loadEntityServiceContext } from './load-entity-service-context.js';
+const getEntityInputSchema = z.object({
+    project: z.string().describe('The name or ID of the project.'),
+    entityId: z
+        .string()
+        .describe('The ID of the entity to retrieve (e.g., "model:abc123").'),
+});
+const getEntityOutputSchema = z.object({
+    entity: z
+        .record(z.string(), z.unknown())
+        .nullable()
+        .describe('The serialized entity data with references resolved to names, or null if not found.'),
+});
+export const getEntityAction = createServiceAction({
+    name: 'get-entity',
+    title: 'Get Entity',
+    description: 'Get the full serialized data for a specific entity by ID. Returns name-resolved JSON.',
+    inputSchema: getEntityInputSchema,
+    outputSchema: getEntityOutputSchema,
+    writeCliOutput: (output) => {
+        if (output.entity === null) {
+            console.info('Entity not found.');
+            return;
+        }
+        console.info(stringifyPrettyStable(output.entity));
+    },
+    handler: async (input, context) => {
+        const { entityContext } = await loadEntityServiceContext(input.project, context);
+        const entity = getEntity(input.entityId, entityContext);
+        return { entity: entity ?? null };
+    },
+});
+//# sourceMappingURL=get-entity.action.js.map

package/dist/actions/definition/get-entity.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity.action.js","sourceRoot":"","sources":["../../../src/actions/definition/get-entity.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC9D,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;IACjD,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,YAAY;IACnB,WAAW,EACT,uFAAuF;IACzF,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,qBAAqB;IACnC,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE;QACzB,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,wBAAwB,CACtD,KAAK,CAAC,OAAO,EACb,OAAO,CACR,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAExD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;IACpC,CAAC;CACF,CAAC,CAAC"}

package/dist/actions/definition/index.d.ts

@@ -0,0 +1,11 @@
+export { commitDraftAction } from './commit-draft.action.js';
+export { discardDraftAction } from './discard-draft.action.js';
+export { getEntitySchemaAction } from './get-entity-schema.action.js';
+export { getEntityAction } from './get-entity.action.js';
+export { listEntitiesAction } from './list-entities.action.js';
+export { listEntityTypesAction } from './list-entity-types.action.js';
+export { showDraftAction } from './show-draft.action.js';
+export { stageCreateEntityAction } from './stage-create-entity.action.js';
+export { stageDeleteEntityAction } from './stage-delete-entity.action.js';
+export { stageUpdateEntityAction } from './stage-update-entity.action.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/definition/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/definition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC"}