@pikku/cli 0.12.123 → 0.12.125

package/dist/.pikku/secrets/pikku-secret-types.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 export { defineSecret } from '@pikku/core/secret';

package/dist/.pikku/secrets/pikku-secret-types.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 export { defineSecret } from '@pikku/core/secret';

package/dist/.pikku/secrets/pikku-secrets.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 import type { SecretService } from '@pikku/core/services';

package/dist/.pikku/secrets/pikku-secrets.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 /**

package/dist/.pikku/services/pikku-meta-service.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export declare class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/services/pikku-meta-service.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/setup/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/setup/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/setup/pikku-setup-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Config and service factory definitions, declared once per application

package/dist/.pikku/setup/pikku-setup-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Config and service factory definitions, declared once per application

package/dist/.pikku/trigger/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Subpath entry — `#pikku/trigger` resolves here.

package/dist/.pikku/trigger/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Subpath entry — `#pikku/trigger` resolves here.

package/dist/.pikku/trigger/pikku-trigger-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization

package/dist/.pikku/trigger/pikku-trigger-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization

package/dist/.pikku/variables/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

package/dist/.pikku/variables/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

package/dist/.pikku/variables/pikku-variable-types.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 export { defineVariable } from '@pikku/core/variable';

package/dist/.pikku/variables/pikku-variable-types.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 export { defineVariable } from '@pikku/core/variable';

package/dist/.pikku/variables/pikku-variables.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 import type { VariablesService } from '@pikku/core/services';

package/dist/.pikku/variables/pikku-variables.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { TypedVariablesService as CoreTypedVariablesService, } from '@pikku/core/services';
 /**

package/dist/.pikku/workflow/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

package/dist/.pikku/workflow/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

package/dist/.pikku/workflow/pikku-workflow-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import type { PikkuWorkflowGraphConfig, PikkuWorkflowGraphResult } from '@pikku/core/workflow';

package/dist/.pikku/workflow/pikku-workflow-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { pikkuWorkflowGraph as corePikkuWorkflowGraph } from '@pikku/core/workflow';

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { pikkuState } from '@pikku/core/state';
 import allWorkflowMeta from './meta/allWorkflow.gen.json' with { type: 'json' };

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.123
+ * This file was generated by @pikku/cli@0.12.125
  */
 import { addWorkflow } from '@pikku/core/workflow';
 import './pikku-workflow-wirings-meta.gen.js';

package/dist/bin/pikku-bin.mjs

@@ -11,8 +11,8 @@ async function checkForUpdate() {
     })
     if (!res.ok) return
     const { version: latest } = await res.json()
-    if (latest !== '0.12.123') {
-      process.stderr.write(`\n  Update available  0.12.123 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
+    if (latest !== '0.12.125') {
+      process.stderr.write(`\n  Update available  0.12.125 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
     }
   } catch {}
 }

package/dist/src/cli.wiring.js

@@ -909,6 +909,13 @@ wireCLI({
                             description: 'Server runtime for the standalone provider: node (bundle.js) or bun (compiled executable)',
                             default: 'node',
                         },
+                        desktop: {
+                            description: 'Also generate a desktop shell (src-tauri/) that runs the compiled binary as a sidecar. Requires --provider standalone --runtime bun, unless --desktop-url is given.',
+                            default: false,
+                        },
+                        desktopUrl: {
+                            description: 'Point the desktop shell at an already-deployed server instead of bundling one. Implies --desktop; nothing is shipped with the app.',
+                        },
                         fromPlan: {
                             description: 'Skip build pipeline, deploy from existing plan output',
                             default: false,

package/dist/src/deploy/build-pipeline.d.ts

@@ -52,6 +52,16 @@ export declare function runBuildPipeline(options: {
     defaultTarget?: 'serverless' | 'server';
     globalHTTPPrefix?: string;
     getEntryContext: (unitDir: string, pikkuDir: string, unit: DeploymentManifest['units'][0], state: InspectorState) => unknown;
+    /**
+     * A built frontend to ship with the bundle, from the project's `frontend`
+     * config. Single-unit builds only — a decomposed deployment has no one unit
+     * that owns the origin the UI would be served from.
+     */
+    frontend?: {
+        dir: string;
+        urlPrefix: string;
+        spaFallback: boolean;
+    };
     deployDir?: string;
     outDir?: string;
     /** Emit sourcemaps + per-unit `metafile.json` (debug-only). Default false. */

package/dist/src/deploy/build-pipeline.js

@@ -11,6 +11,8 @@ import { PikkuError } from '@pikku/core/errors';
 import { analyzeDeployment } from './analyzer/index.js';
 import { withoutScenarios } from '../functions/wirings/scenarios/scenario-partition.js';
 import { generatePerUnitCodegen } from './codegen/per-unit-codegen.js';
+import { materializeFrontend } from './frontend-assets.js';
+import { assertFrontendBuilt } from '../utils/frontend.js';
 import { generateServerEntrySource, SERVER_DOCKERFILE, SERVER_DOCKERIGNORE, } from './server-entry.js';
 /**
  * A unit that failed codegen or bundling is an expected build outcome (the
@@ -100,7 +102,20 @@ export async function runBuildPipeline(options) {
         const unitDir = join(providerDir, unitName);
         const pikkuDir = options.outDir ?? join(projectDir, '.pikku');
         await mkdir(unitDir, { recursive: true });
-        const ctx = getEntryContext(unitDir, pikkuDir, singleUnit, inspectorState);
+        let frontendMount;
+        if (options.frontend) {
+            await assertFrontendBuilt(options.frontend.dir);
+            const keys = await materializeFrontend(options.frontend.dir, unitDir);
+            frontendMount = {
+                urlPrefix: options.frontend.urlPrefix,
+                spaFallback: options.frontend.spaFallback,
+            };
+            logger.info(`Frontend: ${keys.length} files from ${options.frontend.dir}`);
+        }
+        const ctx = {
+            ...getEntryContext(unitDir, pikkuDir, singleUnit, inspectorState),
+            frontend: frontendMount,
+        };
         const source = provider.generateEntrySource(ctx);
         const entryPath = join(unitDir, 'entry.ts');
         await writeFile(entryPath, source, 'utf-8');

package/dist/src/deploy/bundler/bundler.js

@@ -16,6 +16,7 @@ import { writeFile, mkdir, stat, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { createHash } from 'node:crypto';
 import { resolveExternalVersions, generateMinimalPackageJson, } from './dep-extractor.js';
+import { SERVICE_MODULE_MAP } from './service-module-map.js';
 /**
  * Mapping of service name -> gen file pattern that should be stubbed
  * when the service is not required by a deployment unit.
@@ -23,21 +24,6 @@ import { resolveExternalVersions, generateMinimalPackageJson, } from './dep-extr
 const SERVICE_GEN_FILE_MAP = {
     metaService: /pikku-meta-service\.gen/,
 };
-/**
- * Mapping of service name -> npm module patterns to stub when the service is
- * NOT required by a deployment unit. Unlike SERVICE_GEN_FILE_MAP these are
- * external packages, not gen files: a unit that doesn't wire the service never
- * executes the code path that imports them, so replacing them with `export {}`
- * keeps their (often large) trees out of the bundle.
- *
- * The AI SDKs (@pikku/ai-vercel + @ai-sdk/* + `ai`, ~3MB) are only constructed
- * when `agentRunner` is wired (agent units). Every non-agent unit stubs them.
- * The shared services factory must guard the runner construction behind a
- * defined-check on the dynamic import so a stubbed unit simply skips it.
- */
-const SERVICE_MODULE_MAP = {
-    agentRunner: [/^@pikku\/ai-vercel/, /^@ai-sdk\//, /^ai$/],
-};
 /**
  * Read the per-unit pikku-services.gen.ts and return the set of gen file
  * patterns that should be stubbed (because their service is not required).

package/dist/src/deploy/bundler/service-module-map.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Mapping of service name -> npm module patterns to stub when the service is
+ * NOT required by a deployment unit. These are external packages, not gen
+ * files: a unit that doesn't wire the service never executes the code path
+ * that imports them, so replacing them with `export {}` keeps their (often
+ * large) trees out of the bundle.
+ *
+ * The AI SDKs (@pikku/ai-vercel + @ai-sdk/* + `ai`, ~3MB) are only constructed
+ * when `agentRunner` is wired (agent units). Every non-agent unit stubs them.
+ * The shared services factory must guard the runner construction behind a
+ * defined-check on the dynamic import so a stubbed unit simply skips it.
+ *
+ * It lives in its own module so `pikku validate` can warn about a static import
+ * of a stubbed package without pulling the bundler in — a check that reads a
+ * second copy of this list would go stale the first time the list changed.
+ */
+export declare const SERVICE_MODULE_MAP: Record<string, RegExp[]>;

package/dist/src/deploy/bundler/service-module-map.js

@@ -0,0 +1,19 @@
+/**
+ * Mapping of service name -> npm module patterns to stub when the service is
+ * NOT required by a deployment unit. These are external packages, not gen
+ * files: a unit that doesn't wire the service never executes the code path
+ * that imports them, so replacing them with `export {}` keeps their (often
+ * large) trees out of the bundle.
+ *
+ * The AI SDKs (@pikku/ai-vercel + @ai-sdk/* + `ai`, ~3MB) are only constructed
+ * when `agentRunner` is wired (agent units). Every non-agent unit stubs them.
+ * The shared services factory must guard the runner construction behind a
+ * defined-check on the dynamic import so a stubbed unit simply skips it.
+ *
+ * It lives in its own module so `pikku validate` can warn about a static import
+ * of a stubbed package without pulling the bundler in — a check that reads a
+ * second copy of this list would go stale the first time the list changed.
+ */
+export const SERVICE_MODULE_MAP = {
+    agentRunner: [/^@pikku\/ai-vercel/, /^@ai-sdk\//, /^ai$/],
+};

package/dist/src/deploy/frontend-assets.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Embed a built frontend into a `bun build --compile` binary.
+ *
+ * Bun embeds a file imported with `with { type: 'file' }` and hands back an
+ * opaque `/$bunfs/…` path at runtime. That attribute cannot be applied to a
+ * dynamic import, and there is no way to embed a directory, so each file needs
+ * its own literal `import` statement — hence a generated module rather than a
+ * walk at startup.
+ *
+ * esbuild rejects the attribute outright ("Importing with a type attribute of
+ * \"file\" is not supported"), so this module is kept out of the esbuild bundle
+ * as an external and is resolved by the later `bun build --compile` step, which
+ * follows the import from the emitted `bundle.js`.
+ *
+ * The manifest can only name files that already exist, which fixes the build
+ * order: frontend build → manifest generation → server bundle → compile.
+ */
+export declare const FRONTEND_ASSET_MANIFEST_FILE = "frontend-assets.gen.js";
+/** Directory name the built frontend is copied to inside a deploy unit. */
+export declare const FRONTEND_DIR_NAME = "frontend";
+export interface FrontendAsset {
+    /** Mount-relative request path, POSIX-separated (`assets/app-a1b2c3.js`). */
+    key: string;
+    /** Absolute path of the built file. */
+    path: string;
+}
+/**
+ * Every file under `dir`, keyed by its path relative to it.
+ *
+ * Sorted by key: directory read order is not stable across filesystems, and the
+ * manifest feeds a build whose output should not change run to run.
+ */
+export declare function collectFrontendAssets(dir: string): Promise<FrontendAsset[]>;
+/**
+ * The manifest module source, with specifiers relative to `manifestDir` — the
+ * directory the file itself is written to.
+ */
+export declare function generateFrontendAssetManifest(assets: FrontendAsset[], manifestDir: string): string;
+/**
+ * Copy a built frontend into a deploy unit and write the manifest beside it.
+ *
+ * The copy comes first and the manifest is generated from the copy, not the
+ * source: the unit directory is what the bundle and the compile step see, and
+ * the machine that compiles has no reason to still hold the frontend's build
+ * tree. A stale copy is removed rather than merged into, so a file dropped
+ * from the frontend's output cannot survive into the next binary.
+ *
+ * Returns the keys that were embedded, in manifest order.
+ */
+export declare function materializeFrontend(frontendDir: string, unitDir: string): Promise<string[]>;

package/dist/src/deploy/frontend-assets.js

@@ -0,0 +1,82 @@
+/**
+ * Embed a built frontend into a `bun build --compile` binary.
+ *
+ * Bun embeds a file imported with `with { type: 'file' }` and hands back an
+ * opaque `/$bunfs/…` path at runtime. That attribute cannot be applied to a
+ * dynamic import, and there is no way to embed a directory, so each file needs
+ * its own literal `import` statement — hence a generated module rather than a
+ * walk at startup.
+ *
+ * esbuild rejects the attribute outright ("Importing with a type attribute of
+ * \"file\" is not supported"), so this module is kept out of the esbuild bundle
+ * as an external and is resolved by the later `bun build --compile` step, which
+ * follows the import from the emitted `bundle.js`.
+ *
+ * The manifest can only name files that already exist, which fixes the build
+ * order: frontend build → manifest generation → server bundle → compile.
+ */
+import { cp, readdir, rm, writeFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+export const FRONTEND_ASSET_MANIFEST_FILE = 'frontend-assets.gen.js';
+/** Directory name the built frontend is copied to inside a deploy unit. */
+export const FRONTEND_DIR_NAME = 'frontend';
+const toPosix = (value) => value.replace(/\\/g, '/');
+/**
+ * Every file under `dir`, keyed by its path relative to it.
+ *
+ * Sorted by key: directory read order is not stable across filesystems, and the
+ * manifest feeds a build whose output should not change run to run.
+ */
+export async function collectFrontendAssets(dir) {
+    const assets = [];
+    const walk = async (current) => {
+        const entries = await readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const absolute = join(current, entry.name);
+            if (entry.isDirectory()) {
+                await walk(absolute);
+            }
+            else if (entry.isFile()) {
+                assets.push({ key: toPosix(relative(dir, absolute)), path: absolute });
+            }
+        }
+    };
+    await walk(dir);
+    return assets.sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
+}
+/**
+ * The manifest module source, with specifiers relative to `manifestDir` — the
+ * directory the file itself is written to.
+ */
+export function generateFrontendAssetManifest(assets, manifestDir) {
+    const lines = ['// Generated by @pikku/cli — do not edit'];
+    assets.forEach((asset, index) => {
+        const specifier = toPosix(relative(manifestDir, asset.path));
+        lines.push(`import asset${index} from './${specifier}' with { type: 'file' }`);
+    });
+    lines.push('', 'export const frontendAssets = {');
+    assets.forEach((asset, index) => {
+        lines.push(`  '${asset.key}': asset${index},`);
+    });
+    lines.push('}', '');
+    return lines.join('\n');
+}
+/**
+ * Copy a built frontend into a deploy unit and write the manifest beside it.
+ *
+ * The copy comes first and the manifest is generated from the copy, not the
+ * source: the unit directory is what the bundle and the compile step see, and
+ * the machine that compiles has no reason to still hold the frontend's build
+ * tree. A stale copy is removed rather than merged into, so a file dropped
+ * from the frontend's output cannot survive into the next binary.
+ *
+ * Returns the keys that were embedded, in manifest order.
+ */
+export async function materializeFrontend(frontendDir, unitDir) {
+    const target = join(unitDir, FRONTEND_DIR_NAME);
+    await rm(target, { recursive: true, force: true });
+    await cp(frontendDir, target, { recursive: true });
+    const assets = await collectFrontendAssets(target);
+    await writeFile(join(unitDir, FRONTEND_ASSET_MANIFEST_FILE), generateFrontendAssetManifest(assets, unitDir), 'utf-8');
+    return assets.map((asset) => asset.key);
+}

package/dist/src/fabric/fabric-commands.d.ts

@@ -760,6 +760,46 @@ export declare const fabricCommands: {
         projectId: string;
         status: any;
     }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>, import("../../.pikku/middleware/pikku-middleware-types.gen.js").PikkuMiddleware, (services: import("../../types/application-types.js").SingletonServices, data: any, session?: import("../../types/application-types.js").UserSession | undefined) => void | Promise<void>, string>;
+    projects: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+        apiUrl?: string | undefined;
+    }, {
+        projects: {
+            projectId: string;
+            name: string;
+            slug: string;
+            status: string;
+            productionBranch: string;
+            gitRepoUrl: string | null;
+            createdAt: string;
+            linked: boolean;
+        }[];
+    }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+        apiUrl?: string | undefined;
+    }, {
+        projects: {
+            projectId: string;
+            name: string;
+            slug: string;
+            status: string;
+            productionBranch: string;
+            gitRepoUrl: string | null;
+            createdAt: string;
+            linked: boolean;
+        }[];
+    }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+        apiUrl?: string | undefined;
+    }, {
+        projects: {
+            projectId: string;
+            name: string;
+            slug: string;
+            status: string;
+            productionBranch: string;
+            gitRepoUrl: string | null;
+            createdAt: string;
+            linked: boolean;
+        }[];
+    }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>, import("../../.pikku/middleware/pikku-middleware-types.gen.js").PikkuMiddleware, (services: import("../../types/application-types.js").SingletonServices, data: any, session?: import("../../types/application-types.js").UserSession | undefined) => void | Promise<void>, string>;
     errors: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
         branch: string;
         function?: string | undefined;

package/dist/src/fabric/fabric-commands.js

@@ -26,6 +26,7 @@ import { FabricDeployApply, renderDeployApply, } from './functions/deploy.functi
 import { FabricDeployList, renderDeployList, } from './functions/deploy-list.function.js';
 import { FabricDeployUnits, renderDeployUnits, } from './functions/deploy-units.function.js';
 import { FabricStatus, renderStatus } from './functions/status.function.js';
+import { FabricProjectsList, renderProjectsList, } from './functions/projects-list.function.js';
 import { FabricErrors, renderErrors } from './functions/errors.function.js';
 import { FabricDbSchema, renderDbSchema, } from './functions/db-schema.function.js';
 import { FabricRollback } from './functions/rollback.function.js';
@@ -325,6 +326,11 @@ export const fabricCommands = defineCLICommands({
         render: renderStatus,
         description: 'Show the linked project status (active + in-flight deploy)',
     }),
+    projects: pikkuCLICommand({
+        func: FabricProjectsList,
+        render: renderProjectsList,
+        description: 'List the projects in your organization, with their ids (works unlinked)',
+    }),
     errors: pikkuCLICommand({
         func: FabricErrors,
         render: renderErrors,

package/dist/src/fabric/functions/projects-list.function.d.ts

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+export declare const FabricProjectsListInput: z.ZodObject<{
+    apiUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const FabricProjectsListOutput: z.ZodObject<{
+    projects: z.ZodArray<z.ZodObject<{
+        projectId: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+        status: z.ZodString;
+        productionBranch: z.ZodString;
+        gitRepoUrl: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        linked: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * The only fabric command that does not need a linked project, which is the
+ * point of it: a checkout whose config still holds `__PROJECT_ID__` can run
+ * nothing else, and `fabric init` cannot recover the id either — it creates,
+ * so against an existing project it fails with a 409 that carries no id.
+ */
+export declare const FabricProjectsList: import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+    apiUrl?: string | undefined;
+}, {
+    projects: {
+        projectId: string;
+        name: string;
+        slug: string;
+        status: string;
+        productionBranch: string;
+        gitRepoUrl: string | null;
+        createdAt: string;
+        linked: boolean;
+    }[];
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+    apiUrl?: string | undefined;
+}, {
+    projects: {
+        projectId: string;
+        name: string;
+        slug: string;
+        status: string;
+        productionBranch: string;
+        gitRepoUrl: string | null;
+        createdAt: string;
+        linked: boolean;
+    }[];
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+    apiUrl?: string | undefined;
+}, {
+    projects: {
+        projectId: string;
+        name: string;
+        slug: string;
+        status: string;
+        productionBranch: string;
+        gitRepoUrl: string | null;
+        createdAt: string;
+        linked: boolean;
+    }[];
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>;
+type FabricProject = {
+    projectId: string;
+    name: string;
+    gitRepoUrl: string | null;
+    linked: boolean;
+};
+export declare const renderProjectsList: (_s: unknown, { projects }: {
+    projects: FabricProject[];
+}) => void;
+export {};