@promptbook/core 0.114.0-41 → 0.114.0-47

package/umd/src/cli/cli-commands/common/coderGitSyncCliOptions.d.ts

@@ -21,7 +21,7 @@ export declare const CODER_GIT_SYNC_DESCRIPTION: string;
  * Registers the shared `--commit`, `--auto-push` and `--auto-pull` flags on a `ptbk coder` command.
  *
  * Note: Unlike `ptbk coder run`, which commits by default and opts out through `--no-commit`,
- *       these commands never touch git unless the flags are used explicitly.
+ *       these commands only mutate Git when the flags are used explicitly. Workspace detection always runs.
  *
  * @private internal utility of `promptbookCli`
  */

package/umd/src/cli/cli-commands/common/resolveLocalAgentSource.d.ts

@@ -6,8 +6,12 @@ import type { string_book } from '../../../book-2.0/agent-source/string_book';
  * @private internal type of CLI agent resolution
  */
 export type ResolvedLocalAgentSource = {
+    /** Canonical identity used to bound recursive TEAM consultations. */
+    readonly agentUrl: string;
     readonly agentSource: string_book;
     readonly agentReferenceResolver: AgentReferenceResolver;
+    /** Resolves another Book in this collection, retaining its own inheritance and reference locations. */
+    readonly resolveAgentSource: (url: string, signal?: AbortSignal) => Promise<ResolvedLocalAgentSource>;
     /** Newly created books which the coder may include in its initialization commit. */
     readonly createdAgentBookPaths: ReadonlyArray<string>;
 };
@@ -16,4 +20,7 @@ export type ResolvedLocalAgentSource = {
  *
  * @private internal utility of CLI agent resolution
  */
-export declare function resolveLocalAgentSource(agentBookPath: string, currentWorkingDirectory: string): Promise<ResolvedLocalAgentSource>;
+export declare function resolveLocalAgentSource(agentBookPath: string, currentWorkingDirectory: string, options?: {
+    readonly isInitializationAllowed?: boolean;
+    readonly signal?: AbortSignal;
+}): Promise<ResolvedLocalAgentSource>;

package/umd/src/cli/cli-commands/common/validateCoderRunOptions.d.ts

@@ -0,0 +1,6 @@
+import type { RunOptions } from '../../../../scripts/run-codex-prompts/cli/RunOptions';
+/**
+ * Validates cross-flag constraints before workspace setup or the run starts.
+ * @private shared validation for Coder execution commands
+ */
+export declare function validateCoderRunOptions(options: RunOptions): void;

package/umd/src/cli/cli-commands/common/workspaceRepository.d.ts

@@ -0,0 +1,36 @@
+import type { NormalizedQuestionsCliOptions } from './questionsCliOptions';
+/**
+ * Resolved project directory and its enclosing working tree. Project artifacts belong to `projectPath`;
+ * Git paths and synchronization belong to `repositoryRoot`, which may be an enclosing monorepo.
+ *
+ * @private shared workspace context for Coder and workspace server commands
+ */
+export type WorkspaceRepositoryContext = {
+    readonly projectPath: string;
+    readonly repositoryRoot?: string;
+    readonly gitDirectory?: string;
+    readonly repositoryStatus: 'missing' | 'reused' | 'initialized';
+};
+/**
+ * Command policy is separate from discovery: previews never initialize; explicit init needs no confirmation.
+ *
+ * @private shared workspace policy for Coder and workspace server commands
+ */
+export type WorkspaceRepositoryPolicy = 'initialize' | 'mutate' | 'read-only';
+/**
+ * Resolves the requested project once and discovers Git using Git itself, without requiring `HEAD`.
+ * Broken metadata, bare repositories, ownership errors and unavailable Git are failures, not missing repositories.
+ *
+ * @private shared workspace discovery for CLI commands
+ */
+export declare function $resolveWorkspaceRepository(projectDirectory?: string): Promise<WorkspaceRepositoryContext>;
+/**
+ * Checks the shared prerequisite before any project writes, Git synchronization, installation or startup.
+ * Only an affirmative interactive answer or an explicit initializer authorizes `git init`.
+ *
+ * @private shared workspace preflight for Coder and workspace server commands
+ */
+export declare function $preflightWorkspaceRepository(options: {
+    readonly projectDirectory?: string;
+    readonly policy: WorkspaceRepositoryPolicy;
+} & Partial<NormalizedQuestionsCliOptions>): Promise<WorkspaceRepositoryContext>;

package/umd/src/cli/cli-commands/common/workspaceRepository.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/cli/cli-commands/common/workspaceRepositoryCliOptions.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+/**
+ * Shared explanation of the workspace prerequisite, independent of commit and synchronization settings.
+ * @private internal CLI help text
+ */
+export declare const WORKSPACE_REPOSITORY_DESCRIPTION: string;
+/**
+ * Adds shared Git help and the questions switch to every workspace command without duplicating existing options.
+ * @private internal registration helper for workspace CLI commands
+ */
+export declare function addWorkspaceRepositoryOptions(command: Command): void;

package/umd/src/commitments/TEAM/TEAM.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/conversion/archive/loadJsZipModule.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Loads the ZIP archive library (`jszip`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast
+ *
+ * @private internal utility of `loadArchive` and `saveArchive`
+ */
+export declare const loadJsZipModule: () => Promise<{
+    default: typeof import('jszip');
+}>;

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.114.0-40`).
+ * It follows semantic versioning (e.g., `0.114.0-47`).
  *
  * @generated
  */