@pikku/cli 0.12.162 → 0.12.163

package/dist/src/functions/db/ensure-db-types.d.ts

@@ -0,0 +1,12 @@
+import { resolveDb } from './local-db.js';
+/**
+ * Make sure `db/schema.gen.ts` exists before anything is typechecked.
+ *
+ * A fresh project's services import `DB` from `#pikku/db/schema.gen.js`, but
+ * only `pikku db migrate` / `pikku db codegen` used to write it, so the first
+ * `pikku all` failed on a module that had not been generated yet. The types
+ * come from the migrations alone (a scratch database), so nothing needs to be
+ * reachable. If even that fails, an empty `DB` keeps the import resolvable
+ * until `db migrate` writes the real one.
+ */
+export declare function ensureDbTypes(rootDir: string, outDir: string, runtimeDir?: string, dbConfig?: Parameters<typeof resolveDb>[4]): Promise<'present' | 'generated' | 'stubbed' | 'no-db'>;

package/dist/src/functions/db/ensure-db-types.js

@@ -0,0 +1,29 @@
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+import { resolveDb, migrateAndCodegen } from './local-db.js';
+/**
+ * Make sure `db/schema.gen.ts` exists before anything is typechecked.
+ *
+ * A fresh project's services import `DB` from `#pikku/db/schema.gen.js`, but
+ * only `pikku db migrate` / `pikku db codegen` used to write it, so the first
+ * `pikku all` failed on a module that had not been generated yet. The types
+ * come from the migrations alone (a scratch database), so nothing needs to be
+ * reachable. If even that fails, an empty `DB` keeps the import resolvable
+ * until `db migrate` writes the real one.
+ */
+export async function ensureDbTypes(rootDir, outDir, runtimeDir, dbConfig) {
+    const resolved = resolveDb({}, rootDir, outDir, runtimeDir, dbConfig);
+    if (!resolved)
+        return 'no-db';
+    if (existsSync(resolved.schemaFile))
+        return 'present';
+    try {
+        await migrateAndCodegen(resolved, { scratch: true });
+        if (existsSync(resolved.schemaFile))
+            return 'generated';
+    }
+    catch { }
+    mkdirSync(dirname(resolved.schemaFile), { recursive: true });
+    writeFileSync(resolved.schemaFile, 'export interface DB {}\n', 'utf8');
+    return 'stubbed';
+}

package/dist/src/functions/knowledge/console-url.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const ConsoleUrlOutput: z.ZodObject<{
+    consoleUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Where the console shows a knowledge file: the running dev server's address
+ * when there is one, the default port otherwise. The id keeps its slashes so the
+ * link reads as the path it names.
+ */
+export declare const knowledgeConsoleUrl: (config: {
+    rootDir: string;
+    runtimeDir?: string;
+}, path: string) => string | undefined;

package/dist/src/functions/knowledge/console-url.js

@@ -0,0 +1,18 @@
+import { join } from 'node:path';
+import { z } from 'zod';
+import { readDevAddress } from '../commands/dev-address.js';
+const FALLBACK_ORIGIN = 'http://localhost:3000';
+export const ConsoleUrlOutput = z.object({ consoleUrl: z.string().optional() });
+/**
+ * Where the console shows a knowledge file: the running dev server's address
+ * when there is one, the default port otherwise. The id keeps its slashes so the
+ * link reads as the path it names.
+ */
+export const knowledgeConsoleUrl = (config, path) => {
+    if (!path)
+        return undefined;
+    const runtimeDir = config.runtimeDir ?? join(config.rootDir, '.pikku-runtime');
+    const origin = (readDevAddress(runtimeDir)?.apiUrl ?? FALLBACK_ORIGIN).replace(/\/+$/, '');
+    const id = encodeURIComponent(path).replace(/%2F/g, '/');
+    return `${origin}/console/knowledge?id=${id}`;
+};

package/dist/src/functions/knowledge/render.d.ts

@@ -1,10 +1,13 @@
 import type { KnowledgeIndexResult, KnowledgePlanDeferResult, KnowledgePlanProgressResult, KnowledgePlanSchemaResult, KnowledgePlanSetResult, KnowledgePlanShowResult, KnowledgeReconcileResult, KnowledgeValidateResult } from '@pikku/knowledge';
 export declare const renderKnowledgeValidate: (_services: unknown, { ok, notes, findings }: KnowledgeValidateResult) => void;
 export declare const renderKnowledgeIndex: (_services: unknown, { ok, check, files }: KnowledgeIndexResult) => void;
+type ConsoleUrl = {
+    consoleUrl?: string;
+};
 export declare const renderKnowledgePlanSchema: (_services: unknown, { schema }: KnowledgePlanSchemaResult) => void;
-export declare const renderKnowledgePlanShow: (_services: unknown, { ok, path, body }: KnowledgePlanShowResult) => void;
-export declare const renderKnowledgePlanProgress: (_services: unknown, { ok, path, message, done, missing, deferred, problems, }: KnowledgePlanProgressResult) => void;
-export declare const renderKnowledgePlanSet: (_services: unknown, { ok, path, problems, schema }: KnowledgePlanSetResult) => void;
+export declare const renderKnowledgePlanShow: (_services: unknown, { ok, path, body, consoleUrl }: KnowledgePlanShowResult & ConsoleUrl) => void;
+export declare const renderKnowledgePlanProgress: (_services: unknown, { ok, path, message, done, missing, deferred, problems, consoleUrl, }: KnowledgePlanProgressResult & ConsoleUrl) => void;
+export declare const renderKnowledgePlanSet: (_services: unknown, { ok, path, problems, schema, consoleUrl, }: KnowledgePlanSetResult & ConsoleUrl) => void;
 export declare const renderKnowledgePlanDefer: (_services: unknown, { ok, message }: KnowledgePlanDeferResult) => void;
 /**
  * What to do next, and — when only a person can settle it — the question to put to
@@ -17,3 +20,4 @@ export declare const renderKnowledgePlanDefer: (_services: unknown, { ok, messag
  * better reads the same answer as JSON.
  */
 export declare const renderKnowledgeReconcile: (_services: unknown, { kind, reason, note, hold, notes, question, required, satisfied, }: KnowledgeReconcileResult) => void;
+export {};

package/dist/src/functions/knowledge/render.js

@@ -82,10 +82,14 @@ export const renderKnowledgeIndex = (_services, { ok, check, files }) => {
             process.exitCode = 1;
     }
 };
+const printConsoleUrl = (url) => {
+    if (url)
+        console.log(`${dim('see it in the console:')} ${url}`);
+};
 export const renderKnowledgePlanSchema = (_services, { schema }) => {
     console.log(schema);
 };
-export const renderKnowledgePlanShow = (_services, { ok, path, body }) => {
+export const renderKnowledgePlanShow = (_services, { ok, path, body, consoleUrl }) => {
     if (!ok) {
         console.log(`${removed('✗')}  ${body}`);
         process.exitCode = 1;
@@ -93,6 +97,7 @@ export const renderKnowledgePlanShow = (_services, { ok, path, body }) => {
     }
     console.log(dim(path));
     console.log(body);
+    printConsoleUrl(consoleUrl);
 };
 const list = (label, entries, colour) => {
     if (entries.length === 0)
@@ -102,13 +107,14 @@ const list = (label, entries, colour) => {
         console.log(`   ${entry}`);
     console.log();
 };
-export const renderKnowledgePlanProgress = (_services, { ok, path, message, done, missing, deferred, problems, }) => {
+export const renderKnowledgePlanProgress = (_services, { ok, path, message, done, missing, deferred, problems, consoleUrl, }) => {
     if (message) {
         console.log(`${removed('✗')}  ${message}`);
         process.exitCode = 1;
         return;
     }
     console.log(dim(path));
+    printConsoleUrl(consoleUrl);
     console.log();
     list('DONE', done, added);
     list('MISSING', missing, removed);
@@ -134,10 +140,11 @@ export const renderKnowledgePlanProgress = (_services, { ok, path, message, done
     // and not only by whoever is reading the output.
     process.exitCode = 1;
 };
-export const renderKnowledgePlanSet = (_services, { ok, path, problems, schema }) => {
+export const renderKnowledgePlanSet = (_services, { ok, path, problems, schema, consoleUrl, }) => {
     if (ok) {
         console.log(`${added('✓')}  plan written to ${path}`);
         console.log(dim('the build is measured against it'));
+        printConsoleUrl(consoleUrl);
         return;
     }
     console.log(`${removed('✗')}  not written:`);

package/dist/src/functions/knowledge/schemas.d.ts

@@ -64,6 +64,7 @@ export declare const KnowledgePlanProgressOutputSchema: import("zod").ZodObject<
     missing: import("zod").ZodArray<import("zod").ZodString>;
     deferred: import("zod").ZodArray<import("zod").ZodString>;
     problems: import("zod").ZodArray<import("zod").ZodString>;
+    consoleUrl: import("zod").ZodOptional<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>;
 export declare const KnowledgePlanShowInputSchema: import("zod").ZodObject<{
     milestone: import("zod").ZodString;
@@ -73,6 +74,7 @@ export declare const KnowledgePlanShowOutputSchema: import("zod").ZodObject<{
     ok: import("zod").ZodBoolean;
     path: import("zod").ZodString;
     body: import("zod").ZodString;
+    consoleUrl: import("zod").ZodOptional<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>;
 export declare const KnowledgePlanSetInputSchema: import("zod").ZodObject<{
     milestone: import("zod").ZodString;
@@ -83,6 +85,7 @@ export declare const KnowledgePlanSetOutputSchema: import("zod").ZodObject<{
     path: import("zod").ZodString;
     problems: import("zod").ZodArray<import("zod").ZodString>;
     schema: import("zod").ZodOptional<import("zod").ZodString>;
+    consoleUrl: import("zod").ZodOptional<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>;
 export declare const KnowledgePlanDeferInputSchema: import("zod").ZodObject<{
     milestone: import("zod").ZodString;

package/dist/src/functions/knowledge/schemas.js

@@ -1,4 +1,5 @@
 import { KnowledgeIndexInput, KnowledgeIndexOutput, KnowledgePlanDeferInput, KnowledgePlanDeferOutput, KnowledgePlanProgressInput, KnowledgePlanProgressOutput, KnowledgePlanSchemaInput, KnowledgePlanSchemaOutput, KnowledgePlanSetInput, KnowledgePlanSetOutput, KnowledgePlanShowInput, KnowledgePlanShowOutput, KnowledgeReconcileInput, KnowledgeReconcileOutput, KnowledgeValidateInput, KnowledgeValidateOutput, } from '@pikku/knowledge';
+import { ConsoleUrlOutput } from './console-url.js';
 /**
  * The knowledge command schemas, re-bound to variables declared HERE rather than
  * imported straight into the command files.
@@ -26,11 +27,11 @@ export const KnowledgeValidateOutputSchema = KnowledgeValidateOutput;
 export const KnowledgePlanSchemaInputSchema = KnowledgePlanSchemaInput;
 export const KnowledgePlanSchemaOutputSchema = KnowledgePlanSchemaOutput;
 export const KnowledgePlanProgressInputSchema = KnowledgePlanProgressInput;
-export const KnowledgePlanProgressOutputSchema = KnowledgePlanProgressOutput;
+export const KnowledgePlanProgressOutputSchema = KnowledgePlanProgressOutput.extend(ConsoleUrlOutput.shape);
 export const KnowledgePlanShowInputSchema = KnowledgePlanShowInput;
-export const KnowledgePlanShowOutputSchema = KnowledgePlanShowOutput;
+export const KnowledgePlanShowOutputSchema = KnowledgePlanShowOutput.extend(ConsoleUrlOutput.shape);
 export const KnowledgePlanSetInputSchema = KnowledgePlanSetInput;
-export const KnowledgePlanSetOutputSchema = KnowledgePlanSetOutput;
+export const KnowledgePlanSetOutputSchema = KnowledgePlanSetOutput.extend(ConsoleUrlOutput.shape);
 export const KnowledgePlanDeferInputSchema = KnowledgePlanDeferInput;
 export const KnowledgePlanDeferOutputSchema = KnowledgePlanDeferOutput;
 export const KnowledgeReconcileInputSchema = KnowledgeReconcileInput;

package/dist/src/functions/wirings/rpc/serialize-react-query-hooks.js

@@ -108,6 +108,11 @@ import type { FlattenedRPCMap } from '${rpcMapPath}'${workflowImport}
 
 type RPCInvoke = <Name extends keyof FlattenedRPCMap>(name: Name, data: FlattenedRPCMap[Name]['input']) => Promise<FlattenedRPCMap[Name]['output']>
 
+const retryUnlessClientError = (failureCount: number, error: Error) => {
+  const status = (error as { status?: number }).status
+  return !(status !== undefined && status >= 400 && status < 500) && failureCount < 3
+}
+
 export const usePikkuQuery = <Name extends keyof FlattenedRPCMap>(
   name: Name,
   data: FlattenedRPCMap[Name]['input'],
@@ -117,6 +122,7 @@ export const usePikkuQuery = <Name extends keyof FlattenedRPCMap>(
   return useQuery<FlattenedRPCMap[Name]['output'], Error>({
     queryKey: [name, data],
     queryFn: () => rpc.invoke(name, data),
+    retry: retryUnlessClientError,
     ...options,
   })
 }

package/dist/src/functions/workflows/all.workflow.js

@@ -6,6 +6,7 @@ import { warnOnSplitTypeIdentity } from '../validate/type-identity-checks.js';
 import { pruneLegacyScaffoldFiles, refreshScaffoldsImportingRemovedEntryPoints, removeRetiredScaffoldFiles, } from '../../utils/remove-legacy-scaffold-file.js';
 import { writeSurfaceUsage } from '../surface/write-surface-usage.js';
 import { writeSchemaArtifact } from '../db/local-db.js';
+import { ensureDbTypes } from '../db/ensure-db-types.js';
 import { PikkuTypecheckFailedError, renderTscFull, renderTscSummary, runProjectTypecheck, } from '../../utils/tsc-check.js';
 const scaffoldFiles = (config) => {
     const files = [];
@@ -58,9 +59,14 @@ export const allWorkflow = pikkuWorkflowComplexFunc({
         await pruneLegacyScaffoldFiles(config);
         await refreshScaffoldsImportingRemovedEntryPoints(config);
         await removeRetiredScaffoldFiles(config);
+        const needsBootstrap = !existsSync(config.outDir);
+        const dbTypes = await ensureDbTypes(config.rootDir, config.outDir, config.runtimeDir, config.db);
+        if (dbTypes === 'stubbed') {
+            logger.warn('db/schema.gen.ts could not be generated from the migrations; wrote an empty DB until `pikku db migrate` runs');
+        }
         const allImports = [];
         let functionTypesFileExists = true;
-        if (!existsSync(config.outDir)) {
+        if (needsBootstrap) {
             logger.debug(`• .pikku directory not found, running bootstrap first...`);
             // Every `getInspectorState` step below discards its result on purpose. A
             // step's return value is stored as the step result and stays reachable for