@world-engines/create-project 0.1.0-alpha.0

package/dist/initialize.d.ts

@@ -0,0 +1,52 @@
+export interface InitializationIds {
+    readonly project_id: string;
+    readonly local_scenario_id: string;
+    readonly local_view_id: string;
+    readonly snapshot_id: string;
+    readonly operation_id: string;
+}
+export interface InitializeLocalAuthorProjectInput {
+    readonly target: string;
+    readonly install_dependencies?: boolean;
+    readonly verify?: boolean;
+    readonly now_ms?: number;
+    readonly ids?: InitializationIds;
+    readonly npm_executable?: string;
+    /** 仅用于受控嵌入式调用；默认直接执行 npm。 */
+    readonly npm_arguments_prefix?: readonly string[];
+    /** EXE/内部调用可传入已冻结的本地 tgz 目录；未提供时使用固定 prerelease。 */
+    readonly package_source?: VerifiedPackageTarballDirectory;
+    /**
+     * 单文件 CMD 分发入口可以声明目标根中唯一允许保留的启动文件。
+     * 该文件必须是 target 的直接子普通文件；初始化不会覆盖、移动或删除它。
+     */
+    readonly bootstrap_file?: string;
+    /** 已验证便携 runtime 根；CMD 分发会把它复制进项目，供无系统 Node 的 harness/GUI 复用。 */
+    readonly portable_runtime_directory?: string;
+    /** 仅用于集成测试的受控失败点；它只注入失败，绝不伪造安装或验证成功。 */
+    readonly fault_injection?: "disk_write" | "agent_link_post_promote";
+}
+export interface VerifiedPackageTarballDirectory {
+    readonly tarball_directory: string;
+    readonly tarball_directory_sha256: string;
+}
+export interface ProjectInitializationReceiptV1 {
+    readonly schema_version: 1;
+    readonly operation_id: string;
+    readonly project_id: string;
+    readonly status: "ready";
+    readonly initialized_at_ms: number;
+    readonly root_dependencies_installed: boolean;
+    readonly view_dependencies_installed: boolean;
+    readonly dependency_installation: {
+        readonly root: DependencyInstallationReceipt;
+        readonly view: DependencyInstallationReceipt;
+    };
+    readonly verification_completed: boolean;
+    readonly snapshot_digest: string;
+}
+export interface DependencyInstallationReceipt {
+    readonly status: "completed" | "skipped";
+    readonly working_directory: "." | "view";
+}
+export declare function initializeLocalAuthorProject(input: InitializeLocalAuthorProjectInput): Promise<ProjectInitializationReceiptV1>;