refactor(project): tighten the ProjectEvent and create() contracts

src/core/project/manager.test.ts

@@ -56,7 +56,7 @@ async function runCreate(
   while (true) {
     const next = await iterator.next();
     if (next.done) {
-      return { events, project: next.value as Project };
+      return { events, project: next.value };
     }
     events.push(next.value);
   }

src/core/project/manager.tsx

@@ -66,7 +66,7 @@ export class FsProjectManager implements ProjectManager {
     }
   }
 
-  public async *create(input: CreateProjectInput): AsyncGenerator<ProjectEvent> {
+  public async *create(input: CreateProjectInput): AsyncGenerator<ProjectEvent, Project> {
     // Scaffold into a fresh directory, refusing to nest inside an existing project.
     const enclosing = enclosingProjectRoot(process.cwd());
     if (enclosing) {
@@ -106,12 +106,16 @@ export class FsProjectManager implements ProjectManager {
       await this.run(["git", "init"], destination);
     }
 
-    // Return the same shape resolve() would: a created project is a resolvable one.
-    return {
-      name: input.name,
-      rootPath: destination,
-      runtimes: TEMPLATES[input.template].spec.runtimes ?? [],
-    };
+    // A created project is a resolvable one, so read it back rather than
+    // duplicating the template's shape: the returned runtimes are then
+    // schema-validated instead of the template's loosely-typed spec sections.
+    const project = await this.resolve({ filePath: destination });
+    if (!project) {
+      throw new ProjectStateError(
+        `the project scaffolded at ${destination} could not be read back`,
+      );
+    }
+    return project;
   }
 
   // Runs a command with its output streamed to the file logger.

src/handlers/project/create/index.ts

@@ -34,9 +34,7 @@ export const createCreateProjectHandler = (config: CreateProjectHandlerConfig) =
         skipInstall: flags["skip-install"],
         skipGit: flags["skip-git"],
       })) {
-        if (event.message) {
-          config.io.stderr.write(`${event.message}\n`);
-        }
+        config.io.stderr.write(`${event.message}\n`);
       }
 
       config.io.stderr.write(`Created project '${flags["name"]}' in ./${flags["name"]}\n`);

src/handlers/project/types.ts

@@ -22,10 +22,9 @@ export type CreateProjectInput = {
   skipGit?: boolean;
 };
 
+/** A progress step reported while a long-running project operation runs. */
 export type ProjectEvent = {
-  message?: string;
-  subprocessOutput?: string;
-  project?: Project;
+  message: string;
 };
 
 export type ResolveProjectInput = {
@@ -46,7 +45,7 @@ export type Project = {
  */
 export interface ProjectManager {
   /** Scaffold a new AgentCore project from the given template. */
-  create(input: CreateProjectInput): AsyncGenerator<ProjectEvent>;
+  create(input: CreateProjectInput): AsyncGenerator<ProjectEvent, Project>;
 
   /** Locate an existing AgentCore project. Returns undefined if no project can be found. */
   resolve(input: ResolveProjectInput): Promise<Project | undefined>;