@bendyline/gezel 1.0.4 → 1.0.6

package/dist/markdown/index.d.ts

@@ -1,4 +1,4 @@
-import { b as CraftbookDocError, c as CraftbookDoc, Q as ParsedGezel, S as ParsedReportAction, X as ReportActionParseIssue } from '../report-action-UJ-pJpZO.js';
+import { b as CraftbookDocError, c as CraftbookDoc, S as ParsedGezel, U as ParsedReportAction, a1 as ReportActionParseIssue } from '../report-action-ClXIBtpU.js';
 import 'zod';
 
 interface CraftbookMarkdownParse {

package/dist/markdown/index.js

@@ -428,7 +428,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
   z3.object({
     kind: z3.literal("totalMinBytes"),
     files: z3.array(z3.string().min(1)).min(1),
-    bytes: z3.number().int().positive()
+    bytes: z3.number().int().positive(),
+    artifact: z3.boolean().optional()
   }),
   /**
    * At least `min` workspace files with one of `ext` exist (e.g. ≥3 images).
@@ -445,13 +446,15 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
     ext: z3.array(z3.string().min(1)).min(1),
     min: z3.number().int().positive(),
     dir: z3.string().optional(),
-    verifyImageBytes: z3.boolean().optional()
+    verifyImageBytes: z3.boolean().optional(),
+    artifact: z3.boolean().optional()
   }),
   /** Inline `<style>` + linked `.css` in `file` (default index.html) clears `bytes`. */
   z3.object({
     kind: z3.literal("cssMinBytes"),
     bytes: z3.number().int().positive(),
-    file: z3.string().optional()
+    file: z3.string().optional(),
+    artifact: z3.boolean().optional()
   }),
   /** A named content sniff passes on `file` (workspace, or the artifacts drawer when `artifact`). */
   z3.object({
@@ -466,7 +469,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
     file: z3.string().min(1),
     path: z3.string().min(1),
     value: GateJsonScalarSchema,
-    label: z3.string().min(1).optional()
+    label: z3.string().min(1).optional(),
+    artifact: z3.boolean().optional()
   }),
   /** A CSV file has the expected header/row shape and optional picklist values. */
   z3.object({
@@ -476,7 +480,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
     exactColumns: z3.array(z3.string().min(1)).min(1).optional(),
     minRows: z3.number().int().nonnegative().optional(),
     consistentColumns: z3.boolean().optional(),
-    allowedValues: z3.record(z3.string(), z3.array(z3.string().min(1)).min(1)).optional()
+    allowedValues: z3.record(z3.string(), z3.array(z3.string().min(1)).min(1)).optional(),
+    artifact: z3.boolean().optional()
   }),
   /** `file` matches `pattern` (regex), in the workspace or the artifacts drawer when `artifact`. */
   z3.object({
@@ -511,7 +516,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
         label: z3.string().min(1).optional()
       })
     ).min(1),
-    flags: z3.string().optional()
+    flags: z3.string().optional(),
+    artifact: z3.boolean().optional()
   }),
   /**
    * Every inline `<script>` body in `file` (default index.html) parses as
@@ -523,7 +529,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
    */
   z3.object({
     kind: z3.literal("jsParses"),
-    file: z3.string().optional()
+    file: z3.string().optional(),
+    artifact: z3.boolean().optional()
   }),
   /**
    * An in-process, zero-spawn static gate for an HTML deliverable: the document
@@ -534,7 +541,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
    */
   z3.object({
     kind: z3.literal("htmlLint"),
-    file: z3.string().min(1)
+    file: z3.string().min(1),
+    artifact: z3.boolean().optional()
   }),
   /**
    * Named `node:` imports in `file` resolve to real builtin exports, and a
@@ -547,7 +555,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
    */
   z3.object({
     kind: z3.literal("esmImports"),
-    file: z3.string().min(1)
+    file: z3.string().min(1),
+    artifact: z3.boolean().optional()
   }),
   /**
    * `file` parses as source code. For `.ts/.tsx/.js/.mjs/.cjs/.jsx` the
@@ -559,7 +568,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
    */
   z3.object({
     kind: z3.literal("sourceParses"),
-    file: z3.string().min(1)
+    file: z3.string().min(1),
+    artifact: z3.boolean().optional()
   }),
   /**
    * The first Markdown table in `file` has the required header set and
@@ -601,6 +611,12 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
    * dependency-free files can run (node built-ins ok; the sandbox has no
    * npm tree): a `node:test`/`assert` file exits nonzero on failure,
    * which is exactly the contract.
+   *
+   * Alone among the file-reading checks this takes no `artifact` flag: it
+   * does not read through the swappable gate reader at all, it hands the
+   * path to the sandbox executor, which resolves against the workspace.
+   * Accepting the flag would parse fine and then silently execute the
+   * wrong tree — the exact failure mode the flag exists to prevent.
    */
   z3.object({
     kind: z3.literal("nodeRuns"),
@@ -639,8 +655,11 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
   }),
   /**
    * A PR-review coverage ledger must name every changed path materialized in
-   * a connector corpus. The ledger is workspace JSON (`reviewedFiles` by
-   * default); the source records live in the read-only artifacts drawer and
+   * a connector corpus. The ledger is JSON (`reviewedFiles` by default) in
+   * the workspace, or in the artifacts drawer when `artifact` — a review of
+   * a read-only checkout can only write the drawer, so omitting the flag
+   * here made the whole Pull Request Review book unsatisfiable on any
+   * writes-off project. The source records always live in the drawer and
    * carry their authoritative path in frontmatter. This prevents a polished
    * report from passing after only the first context-sized prefix was read.
    */
@@ -649,7 +668,49 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
     file: z3.string().min(1),
     corpusDir: z3.string().min(1),
     reviewedField: z3.string().min(1).optional(),
-    recordField: z3.string().min(1).optional()
+    recordField: z3.string().min(1).optional(),
+    artifact: z3.boolean().optional(),
+    /**
+     * JSON array of the exact changed paths THIS ledger must cover, as a
+     * string — narrows the check from the whole corpus to one slice of it.
+     * Written for declarative fanout: a child reviewing batch 2 of 3 gets
+     * `"{{paths}}"` from its per-item context and is gated on its own 25
+     * files, not on the 68 nobody handed it. Without this a batch child
+     * can never pass its own gate, and coverage can only be enforced
+     * after a merge — far downstream of the child that under-delivered.
+     *
+     * Fails closed on anything that is not a JSON array of strings,
+     * including an uninterpolated `{{…}}` token: a mis-scoped coverage
+     * check that silently widens back to the full corpus would reject
+     * every child forever with a verdict none of them can act on.
+     */
+    expectPaths: z3.string().min(1).optional()
+  }),
+  /**
+   * A fanout-input batch file must reproduce a connector corpus manifest's own
+   * batch array exactly — same count, same ordinals, same paths, in order.
+   *
+   * The upstream sibling of {@link corpusCoverage}: that check proves the work
+   * covered the corpus, this one proves the *plan* did. A batch file is the
+   * spawn host's `overFile`, so a batch dropped here is never reviewed by
+   * anyone and never appears in any coverage ledger. `json-valid` + `minBytes`
+   * cannot see it: a batch array truncated at the model's output cap is still
+   * syntactically perfect JSON. Wild-caught on a 509-file PR whose scope step
+   * published 10 of 21 batches — 259 files silently out of scope, and the run
+   * then deadlocked eight attempts deep in the downstream merge gate, which is
+   * the wrong place to learn it and the one place that cannot fix it.
+   */
+  z3.object({
+    kind: z3.literal("corpusBatches"),
+    file: z3.string().min(1),
+    corpusDir: z3.string().min(1),
+    /** Filename suffix identifying the manifest inside the corpus. */
+    manifestSuffix: z3.string().min(1).optional(),
+    /** Manifest field holding the authoritative batch array. */
+    itemsField: z3.string().min(1).optional(),
+    /** Manifest field holding the total item count the batches must cover. */
+    totalField: z3.string().min(1).optional(),
+    artifact: z3.boolean().optional()
   }),
   /**
    * The H1 slide titles in `file` must match the numbered slide headings in
@@ -662,7 +723,8 @@ var GateCheckSchema = z3.discriminatedUnion("kind", [
     file: z3.string().min(1),
     outlineFile: z3.string().min(1),
     /** Read outlineFile from artifacts while file uses the check's primary surface. */
-    outlineArtifact: z3.boolean().optional()
+    outlineArtifact: z3.boolean().optional(),
+    artifact: z3.boolean().optional()
   }),
   /**
    * Named facts in `file` must come from authorized sources: each fact
@@ -3009,6 +3071,26 @@ var ChatMessageToolCallSchema = z17.object({
   addedLines: z17.number().int().nonnegative().optional(),
   removedLines: z17.number().int().nonnegative().optional()
 });
+var ChatSessionSourceSchema = z17.object({
+  kind: z17.literal("external"),
+  /** Stable integration id, e.g. `pi`. */
+  appId: z17.string().min(1),
+  /** Human-facing application name, e.g. `Pi`. */
+  appName: z17.string().min(1),
+  /** The external application's stable conversation/session identifier. */
+  externalConversationId: z17.string().min(1),
+  /** External threads are ledger views; the owning app controls replies. */
+  readOnly: z17.literal(true),
+  /** Working-directory hint supplied by the external app, when available. */
+  workingDirectory: z17.string().optional(),
+  /** Project id/name hint supplied by the external app, when available. */
+  projectHint: z17.string().optional()
+});
+var ReferencedFileKindSchema = z17.enum(["artifact", "workspace"]);
+var ReferencedFileSchema = z17.object({
+  kind: ReferencedFileKindSchema,
+  path: z17.string()
+});
 var ChatMessageSchema = z17.object({
   role: z17.enum(["user", "assistant"]),
   content: z17.string(),
@@ -3018,17 +3100,27 @@ var ChatMessageSchema = z17.object({
     gezelName: z17.string()
   }).optional(),
   /**
-   * Artifact paths (relative to the project's `artifacts/` directory)
-   * the assistant reply referenced in its body text. Populated on save
-   * by the server-side reference parser, and used by the chat UI to
-   * render a chip row under the bubble and to linkify inline code spans
-   * that match a real artifact. Back-stops Copilot's tool-call
-   * blindspot and any "AI wrote a file outside the MCP tools" paths.
+   * Real files the assistant reply named in its body text — artifacts
+   * drawer and workspace tree alike. Populated on save by the
+   * server-side reference parser, and used by the chat UI to render a
+   * chip row under the bubble and to linkify inline code spans that
+   * match a real file. Back-stops Copilot's tool-call blindspot and any
+   * "AI wrote a file outside the MCP tools" path.
+   */
+  referencedFiles: z17.array(ReferencedFileSchema).optional(),
+  /**
+   * The artifact-only projection of {@link referencedFiles}, still
+   * written so an older `@bendyline/gezel-cli` (or any out-of-tree
+   * reader) keeps working against a session file this daemon wrote.
+   * Read `referencedFiles` in new code — this field cannot represent a
+   * workspace path.
+   *
+   * @deprecated superseded by `referencedFiles`
    */
   referencedArtifacts: z17.array(z17.string()).optional(),
   /**
    * Task refs (`<projectId>/<num>`) the assistant reply mentioned. Same
-   * shape as `referencedArtifacts` — populated on save, gated on the
+   * shape as `referencedFiles` — populated on save, gated on the
    * ref actually existing in the task store, surfaced in the chat
    * bubble as click-through chips. Catches the common "I created task
    * gezel-ux-roadmap/2" mention so the user can jump to it without
@@ -3121,6 +3213,25 @@ var ChatMessageSchema = z17.object({
    * renders a small "nudged" chip on the bubble.
    */
   nudge: z17.boolean().optional(),
+  /**
+   * The machinery — not the human — authored this `role: 'user'` message.
+   * Task dispatch seeds, step handoffs, and project-page reaction seeds
+   * all arrive as user turns because that is the only role a provider
+   * will accept mid-conversation, but the person never typed them.
+   *
+   * Display-only marker: the model still sees an ordinary user turn, and
+   * the UI labels the bubble **System** instead of "You". Without it the
+   * flagship Home thread opened with "YOU · call `advance_task_step` to
+   * hand off" — internal plumbing quoted back at the user in their own
+   * voice, which reads as a bug and undoes the warm-companion framing the
+   * whole product rests on.
+   *
+   * Set from the turn's `messageOrigin` (service-side `TurnMessageOrigin`);
+   * an enum rather than a boolean so a future dispatch/reaction split can
+   * widen it without a second field. Messages written before this field
+   * existed are inferred at read time — see `Store.listTimeline`.
+   */
+  origin: z17.enum(["system"]).optional(),
   /**
    * Persistent warnings attached to this assistant turn — fabricated
    * tool-use detection, degraded provider state, etc. The streaming
@@ -3215,6 +3326,12 @@ var ChatEventSchema = z17.discriminatedUnion("type", [
    */
   z17.object({ type: z17.literal("reasoning_delta"), content: z17.string() }),
   z17.object({ type: z17.literal("complete"), message: ChatMessageSchema }),
+  /**
+   * The user submitted a message, but a cold provider session is still being
+   * created. Project timelines render this as a temporary pending row until
+   * the durable `user_message` or a terminal `error` arrives.
+   */
+  z17.object({ type: z17.literal("user_message_pending"), preview: z17.string() }),
   /**
    * Emitted right after the user's message is appended to the session
    * record. The legacy session-scoped UI inserted user messages locally
@@ -3538,11 +3655,27 @@ var ChatEventSchema = z17.discriminatedUnion("type", [
     phase: z17.enum(["starting", "loading_model", "prefill", "generating", "ready"]),
     detail: z17.string().optional(),
     progress: z17.number().min(0).max(1).optional(),
-    ttftMs: z17.number().int().nonnegative().optional()
+    ttftMs: z17.number().int().nonnegative().optional(),
+    /**
+     * Exact cumulative completion tokens decoded so far this turn, as the
+     * engine counts them (llama-server `timings.predicted_n`, MLX's
+     * streamed `usage.output_tokens`). Present only on `generating`, and
+     * only for engines that publish a running counter — the UI falls back
+     * to an explicitly-approximate character estimate when it is absent,
+     * so this field is what lets a readout drop its "≈".
+     */
+    outputTokens: z17.number().int().nonnegative().optional(),
+    /**
+     * Exact decode rate right now, engine-measured over the generation
+     * phase alone (llama-server `timings.predicted_per_second`, MLX's
+     * `generation_tps`). Same contract as `outputTokens`: absent means the
+     * UI must derive and mark its own estimate.
+     */
+    tokensPerSec: z17.number().nonnegative().optional()
   }),
   /**
-   * Per-turn telemetry for locally-hosted providers (llama-cpp +
-   * Ollama). Emitted once at turn end with the concrete token counts
+   * Per-turn telemetry for locally-hosted providers (llama-cpp, Ollama,
+   * MLX, and DS4). Emitted once at turn end with the concrete token counts
    * the UI needs for a speed readout — input tokens, output tokens,
    * wall-clock duration, and tokens-per-second on the generation
    * phase. UI accumulates these in a rolling window to show an
@@ -3556,6 +3689,13 @@ var ChatEventSchema = z17.discriminatedUnion("type", [
   z17.object({
     type: z17.literal("turn_stats"),
     provider: z17.enum(["llama-cpp", "ollama", "mlx", "ds4"]),
+    /**
+     * Model that generated the turn, as the session recorded it. Lets the
+     * UI bucket speed by model instead of averaging a 27B and a 4B into
+     * one meaningless number. Optional because older daemons (and remote
+     * peers on an older wire) don't send it.
+     */
+    model: z17.string().optional(),
     promptTokens: z17.number().int().nonnegative(),
     completionTokens: z17.number().int().nonnegative(),
     durationMs: z17.number().int().nonnegative(),
@@ -3716,6 +3856,19 @@ var ChatEventSchema = z17.discriminatedUnion("type", [
     state: z17.enum(["started", "ended", "failed"]),
     generatedAt: z17.string().optional()
   }),
+  /**
+   * Global signal from the ambient dashboard generator. `ended` means a
+   * fresh PNG landed on disk (filename is the dated file under
+   * `~/.gezel/ambient/`); the Electron shell reacts to it by re-applying
+   * the wallpaper when the user opted in, and the Settings card
+   * refreshes its preview.
+   */
+  z17.object({
+    type: z17.literal("ambient_dashboard"),
+    state: z17.enum(["started", "ended", "failed"]),
+    generatedAt: z17.string().optional(),
+    filename: z17.string().optional()
+  }),
   /**
    * Global (history-free) heartbeat from the boekwachter indexing loops —
    * workspace scans, AI enrichment batches, weekly digests. Drives the live
@@ -3739,6 +3892,8 @@ var ChatEventEnvelopeSchema = z17.object({
   sessionId: z17.string(),
   gezelId: z17.string(),
   projectId: z17.string(),
+  /** Present for externally-owned read-only threads, including live turns. */
+  sessionSource: ChatSessionSourceSchema.optional(),
   event: ChatEventSchema
 });
 

package/dist/paths.d.ts

@@ -314,6 +314,18 @@ declare function projectActivityFile(root: string, projectId: string): string;
 declare function meesterStatusDir(root: string): string;
 declare function meesterStatusFile(root: string): string;
 declare function meesterStatusStateFile(root: string): string;
+/**
+ * Home for the ambient dashboard — meester-generated PNG snapshots of the
+ * whole workshop, written for the OS ambient-display integration (wallpaper
+ * rotation points here). Holds dated `dashboard-*.png` files, a stable
+ * `latest.png` copy, the generator's `state.json`, and the Electron
+ * applier's `display-state.json` + `applied-a/b.png` slots. Per-user only —
+ * never under machineSharedHome: wallpaper is user-session state.
+ */
+declare function ambientDir(root: string): string;
+declare function ambientDashboardStateFile(root: string): string;
+declare function ambientDashboardLatestFile(root: string): string;
+declare function ambientDisplayStateFile(root: string): string;
 declare function projectTasksDir(root: string, projectId: string, external?: ExternalFolders): string;
 declare function projectTaskNextIdFile(root: string, projectId: string, external?: ExternalFolders): string;
 declare function projectTaskDir(root: string, projectId: string, num: number, external?: ExternalFolders): string;
@@ -432,7 +444,16 @@ declare function fallbackProjectIndexDir(root: string, projectId: string): strin
  * retain the historical `.gezel/index/` placement; machine-shared workspaces
  * always use the account-private fallback to prevent cross-daemon SQLite use.
  */
-declare function projectContentIndexDbFile(root: string, projectId: string, workspaceDir: string): string;
+declare function projectContentIndexDbFile(root: string, projectId: string, workspaceDir: string, opts?: {
+    /**
+     * Keep the database out of the workspace even though it is writable.
+     * The shared document library's workspace is the user's own documents
+     * folder, which may be a cloud-synced directory (OneDrive/Dropbox):
+     * mutable SQLite must not ride a sync client, and the user must not find
+     * a `.gezel/` directory in a folder they browse in Finder.
+     */
+    forceHomeSide?: boolean;
+}): string;
 /**
  * Derived FTS index over a project's artifact corpora (connector records under
  * `artifacts/data/**`). Always in the account-private sidecar, never inside
@@ -585,6 +606,21 @@ declare function keurmeesterCasesDir(root: string): string;
 declare function keurmeesterDigestsDir(root: string): string;
 /** Digest idempotency state (last generated date, last case offset). */
 declare function keurmeesterDigestStatePath(root: string): string;
+/**
+ * Root of every downloaded engine payload: per-engine model stores, the
+ * verified native binary releases, the HuggingFace cache, uv virtualenvs,
+ * and per-engine scratch. This is the bulk of a heavy install's disk use —
+ * on a working machine it dwarfs everything else in the home directory
+ * combined. Owned by the engine/model managers, not the Store.
+ */
+declare function enginesRoot(root: string): string;
+/**
+ * Pinned node + pnpm runtimes the supervisor extracts so packaged installs
+ * need no system toolchain. The daemon executes through these, so nothing
+ * daemon-side may delete them; the platform uninstaller owns removal and the
+ * supervisor re-extracts on a sentinel mismatch.
+ */
+declare function binRuntimeRoot(root: string): string;
 /**
  * Read the on-disk `config.json` without instantiating a Store. Used at
  * boot to discover `externalFolders` before the Store is constructed
@@ -598,4 +634,4 @@ declare function keurmeesterDigestStatePath(root: string): string;
  */
 declare function readConfigRaw(root: string): Promise<Record<string, unknown>>;
 
-export { type ExternalFolders, type GezelPaths, MACHINE_SHARED_MARKER, type MachineStorageScope, PROJECT_SHADOW_DIR_NAME, activeMachineSharedHome, backupsDir, channelsDir, craftbookShardPrefix, craftbookTemplateDir, craftbookTemplateManifestFile, craftbookTemplateScriptFile, craftbookTemplateScriptsDir, craftbookTemplateVersionDir, craftbookTemplateVersionManifestFile, craftbookTemplatesRoot, daemonTransactionsRoot, deviceIdentityFile, fallbackProjectIndexDir, fallbackProjectVillageFile, foldersStateDir, gezelDir, gezelGrowthPath, gezelHome, gezelLocalDir, gezelMemoriesDir, gezelPaths, gezelPoppetjePath, gezelSessionFile, gezelSessionsDir, gezelStorageScope, gezelToolsPath, gezelToolsetsFile, gezelToolsetsInstallDir, gildeLiveRoot, gildeLiveStateFile, gildeLiveVersionDir, gildeLiveVersionsDir, globalHistoryFile, globalIndexDbFile, globalIndexDir, keurmeesterCasesDir, keurmeesterDigestStatePath, keurmeesterDigestsDir, keurmeesterDir, machineSharedGezelDir, machineSharedHome, machineSharedMarkerFile, machineSharedProjectDir, meesterStatusDir, meesterStatusFile, meesterStatusStateFile, pendingGrantsFile, playwrightBrowsersDir, projectActivityFile, projectArtifactsDir, projectArtifactsIndexDbFile, projectBoekwachterIssuesFile, projectCodeReviewsFile, projectContentIndexDbFile, projectCreateTransactionsRoot, projectDir, projectDocsDir, projectFindingLifecycleFile, projectHistoryFile, projectIndexDir, projectInternalGithubDir, projectLocalConfigFile, projectLocalCraftbookDir, projectLocalCraftbooksRoot, projectLocalDir, projectLocalFilesDir, projectLocalGezelDir, projectLocalGezelsRoot, projectLocalImportsFile, projectLocalIndexDbFile, projectLocalIndexDir, projectLocalPendingImportsFile, projectLocalQuarantineDir, projectLocalRoot, projectLocalVillageFile, projectMemoriesDir, projectMemoryIndexDir, projectMetaFile, projectPrivateDir, projectQuestionsFile, projectReportActionsFile, projectScriptFile, projectScriptRunFile, projectScriptRunsDir, projectScriptsDir, projectShadowDir, projectStorageDir, projectStorageScope, projectTaskAboutFile, projectTaskDir, projectTaskFile, projectTaskNextIdFile, projectTaskNotesFile, projectTasksDir, projectTerminalFile, projectTerminalsDir, projectToolsetsFile, projectToolsetsInstallDir, projectTypeDir, projectTypeManifestFile, projectTypeShardPrefix, projectTypeVersionDir, projectTypeVersionManifestFile, projectTypesRoot, readConfigRaw, remotesFile, secretsFile, secretsKeyFile, sharedCloneDir, sharedClonesRoot, sharedToolsetsFile, sharedToolsetsInstallDir, systemInstalledToolsetsFile, systemToolsetsFile, systemToolsetsInstallDir, tokensFile, toolsetConfigFile, toolsetConfigsDir, userGezelDir, userProjectDir, userScriptFile, userScriptsDir };
+export { type ExternalFolders, type GezelPaths, MACHINE_SHARED_MARKER, type MachineStorageScope, PROJECT_SHADOW_DIR_NAME, activeMachineSharedHome, ambientDashboardLatestFile, ambientDashboardStateFile, ambientDir, ambientDisplayStateFile, backupsDir, binRuntimeRoot, channelsDir, craftbookShardPrefix, craftbookTemplateDir, craftbookTemplateManifestFile, craftbookTemplateScriptFile, craftbookTemplateScriptsDir, craftbookTemplateVersionDir, craftbookTemplateVersionManifestFile, craftbookTemplatesRoot, daemonTransactionsRoot, deviceIdentityFile, enginesRoot, fallbackProjectIndexDir, fallbackProjectVillageFile, foldersStateDir, gezelDir, gezelGrowthPath, gezelHome, gezelLocalDir, gezelMemoriesDir, gezelPaths, gezelPoppetjePath, gezelSessionFile, gezelSessionsDir, gezelStorageScope, gezelToolsPath, gezelToolsetsFile, gezelToolsetsInstallDir, gildeLiveRoot, gildeLiveStateFile, gildeLiveVersionDir, gildeLiveVersionsDir, globalHistoryFile, globalIndexDbFile, globalIndexDir, keurmeesterCasesDir, keurmeesterDigestStatePath, keurmeesterDigestsDir, keurmeesterDir, machineSharedGezelDir, machineSharedHome, machineSharedMarkerFile, machineSharedProjectDir, meesterStatusDir, meesterStatusFile, meesterStatusStateFile, pendingGrantsFile, playwrightBrowsersDir, projectActivityFile, projectArtifactsDir, projectArtifactsIndexDbFile, projectBoekwachterIssuesFile, projectCodeReviewsFile, projectContentIndexDbFile, projectCreateTransactionsRoot, projectDir, projectDocsDir, projectFindingLifecycleFile, projectHistoryFile, projectIndexDir, projectInternalGithubDir, projectLocalConfigFile, projectLocalCraftbookDir, projectLocalCraftbooksRoot, projectLocalDir, projectLocalFilesDir, projectLocalGezelDir, projectLocalGezelsRoot, projectLocalImportsFile, projectLocalIndexDbFile, projectLocalIndexDir, projectLocalPendingImportsFile, projectLocalQuarantineDir, projectLocalRoot, projectLocalVillageFile, projectMemoriesDir, projectMemoryIndexDir, projectMetaFile, projectPrivateDir, projectQuestionsFile, projectReportActionsFile, projectScriptFile, projectScriptRunFile, projectScriptRunsDir, projectScriptsDir, projectShadowDir, projectStorageDir, projectStorageScope, projectTaskAboutFile, projectTaskDir, projectTaskFile, projectTaskNextIdFile, projectTaskNotesFile, projectTasksDir, projectTerminalFile, projectTerminalsDir, projectToolsetsFile, projectToolsetsInstallDir, projectTypeDir, projectTypeManifestFile, projectTypeShardPrefix, projectTypeVersionDir, projectTypeVersionManifestFile, projectTypesRoot, readConfigRaw, remotesFile, secretsFile, secretsKeyFile, sharedCloneDir, sharedClonesRoot, sharedToolsetsFile, sharedToolsetsInstallDir, systemInstalledToolsetsFile, systemToolsetsFile, systemToolsetsInstallDir, tokensFile, toolsetConfigFile, toolsetConfigsDir, userGezelDir, userProjectDir, userScriptFile, userScriptsDir };

package/dist/paths.js

@@ -286,6 +286,18 @@ function meesterStatusFile(root) {
 function meesterStatusStateFile(root) {
   return join(meesterStatusDir(root), "state.json");
 }
+function ambientDir(root) {
+  return join(root, "ambient");
+}
+function ambientDashboardStateFile(root) {
+  return join(ambientDir(root), "state.json");
+}
+function ambientDashboardLatestFile(root) {
+  return join(ambientDir(root), "latest.png");
+}
+function ambientDisplayStateFile(root) {
+  return join(ambientDir(root), "display-state.json");
+}
 function projectTasksDir(root, projectId, external) {
   return join(projectDir(root, projectId, external), "tasks");
 }
@@ -382,8 +394,8 @@ function projectLocalQuarantineDir(workspaceDir) {
 function fallbackProjectIndexDir(root, projectId) {
   return join(projectPrivateDir(root, projectId), "index");
 }
-function projectContentIndexDbFile(root, projectId, workspaceDir) {
-  return projectStorageScope(root, projectId) === "machine-shared" ? join(fallbackProjectIndexDir(root, projectId), "index.db") : projectLocalIndexDbFile(workspaceDir);
+function projectContentIndexDbFile(root, projectId, workspaceDir, opts = {}) {
+  return opts.forceHomeSide || projectStorageScope(root, projectId) === "machine-shared" ? join(fallbackProjectIndexDir(root, projectId), "index.db") : projectLocalIndexDbFile(workspaceDir);
 }
 function projectArtifactsIndexDbFile(root, projectId) {
   return join(fallbackProjectIndexDir(root, projectId), "artifacts.db");
@@ -497,6 +509,12 @@ function keurmeesterDigestsDir(root) {
 function keurmeesterDigestStatePath(root) {
   return join(keurmeesterDir(root), "digest-state.json");
 }
+function enginesRoot(root) {
+  return join(root, "engines");
+}
+function binRuntimeRoot(root) {
+  return join(root, "bin");
+}
 async function readConfigRaw(root) {
   const { readFile } = await import("fs/promises");
   try {
@@ -510,7 +528,12 @@ export {
   MACHINE_SHARED_MARKER,
   PROJECT_SHADOW_DIR_NAME,
   activeMachineSharedHome,
+  ambientDashboardLatestFile,
+  ambientDashboardStateFile,
+  ambientDir,
+  ambientDisplayStateFile,
   backupsDir,
+  binRuntimeRoot,
   channelsDir,
   craftbookShardPrefix,
   craftbookTemplateDir,
@@ -522,6 +545,7 @@ export {
   craftbookTemplatesRoot,
   daemonTransactionsRoot,
   deviceIdentityFile,
+  enginesRoot,
   fallbackProjectIndexDir,
   fallbackProjectVillageFile,
   foldersStateDir,