@pikku/cli 0.12.151 → 0.12.152

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

@@ -45,6 +45,7 @@ import { FabricDomainsRemove } from './functions/domains-remove.function.js';
 import { FabricLLMKey, renderLLMKey } from './functions/llm-key.function.js';
 import { FabricChangesList, renderChangesList, } from './functions/changes-list.function.js';
 import { FabricChangesShow, renderChangesShow, } from './functions/changes-show.function.js';
+import { FabricChangesFile, renderChangesFile, } from './functions/changes-file.function.js';
 import { FabricChangesClaim, renderChangesClaim, } from './functions/changes-claim.function.js';
 import { FabricChangesAsk, renderChangesAsk, } from './functions/changes-ask.function.js';
 import { FabricChangesShot, renderChangesShot, } from './functions/changes-shot.function.js';
@@ -482,7 +483,7 @@ export const fabricCommands = defineCLICommands({
         },
     },
     changes: {
-        description: 'The todo list filed from inside a deployed stage: read what is open, claim a batch, ask what you need to know, and tick items off',
+        description: 'The todo list filed from inside a deployed stage: read what is open, file what was decided elsewhere, claim a batch, ask what you need to know, and tick items off',
         subcommands: {
             list: pikkuCLICommand({
                 func: FabricChangesList,
@@ -524,6 +525,36 @@ export const fabricCommands = defineCLICommands({
                     apiUrl: { description: 'Override the fabric-api URL for this call' },
                 },
             }),
+            file: pikkuCLICommand({
+                func: FabricChangesFile,
+                render: renderChangesFile,
+                description: 'File an item from outside the panel — the words, without the screenshot the panel would have attached',
+                options: {
+                    projectId: {
+                        description: 'Project to file against (defaults to the linked checkout)',
+                        short: 'p',
+                    },
+                    stageId: {
+                        description: 'Stage to file against (defaults to the only stage)',
+                    },
+                    branch: {
+                        description: 'Resolve the stage from this branch instead',
+                    },
+                    title: {
+                        description: 'The requirement, in one line',
+                        short: 't',
+                    },
+                    body: { description: 'The detail, if a line is not enough' },
+                    bodyFile: {
+                        description: 'Read the body from a file — use this when it has newlines',
+                    },
+                    route: {
+                        description: 'The route it is about, e.g. /admin/rota',
+                    },
+                    locale: { description: 'Locale it was seen in, e.g. de' },
+                    apiUrl: { description: 'Override the fabric-api URL for this call' },
+                },
+            }),
             claim: pikkuCLICommand({
                 func: FabricChangesClaim,
                 render: renderChangesClaim,

package/dist/src/fabric/functions/changes-file.function.d.ts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import type { CreateChangeOutput } from '../sdk/rpc-map.gen.d.js';
+export declare const FabricChangesFileInput: z.ZodObject<{
+    apiUrl: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    stageId: z.ZodOptional<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    body: z.ZodOptional<z.ZodString>;
+    bodyFile: z.ZodOptional<z.ZodString>;
+    route: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const FabricChangesFileOutput: z.ZodObject<{
+    change: z.ZodAny;
+}, z.core.$strip>;
+/**
+ * An item filed from a terminal carries no screenshot, no circled elements and
+ * no build — the panel supplies those and nothing here can invent them. What it
+ * does carry is the words, which the skill already treats as the requirement
+ * and every other address as evidence, so a written item is a thinner but not a
+ * malformed one.
+ *
+ * `--body-file` because a real item's body is a paragraph with newlines in it,
+ * and putting that through shell quoting is where it gets mangled.
+ */
+export declare const FabricChangesFile: import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+    apiUrl?: string | undefined;
+    projectId?: string | undefined;
+    stageId?: string | undefined;
+    branch?: string | undefined;
+    title: string;
+    body?: string | undefined;
+    bodyFile?: string | undefined;
+    route?: string | undefined;
+    locale?: string | undefined;
+}, {
+    change: any;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+    apiUrl?: string | undefined;
+    projectId?: string | undefined;
+    stageId?: string | undefined;
+    branch?: string | undefined;
+    title: string;
+    body?: string | undefined;
+    bodyFile?: string | undefined;
+    route?: string | undefined;
+    locale?: string | undefined;
+}, {
+    change: any;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices> | import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+    apiUrl?: string | undefined;
+    projectId?: string | undefined;
+    stageId?: string | undefined;
+    branch?: string | undefined;
+    title: string;
+    body?: string | undefined;
+    bodyFile?: string | undefined;
+    route?: string | undefined;
+    locale?: string | undefined;
+}, {
+    change: any;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown>, undefined, undefined>;
+export declare const renderChangesFile: (_s: unknown, { change }: CreateChangeOutput) => void;

package/dist/src/fabric/functions/changes-file.function.js

@@ -0,0 +1,56 @@
+import { readFile } from 'node:fs/promises';
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '../../../.pikku/function/index.js';
+import { changesContext, requireProjectId } from '../lib/changes.js';
+import { resolveStageId } from '../lib/stage.js';
+import { dim, safe } from '../lib/output.js';
+export const FabricChangesFileInput = z.object({
+    apiUrl: z.string().optional(),
+    projectId: z.string().optional(),
+    stageId: z.string().optional(),
+    branch: z.string().optional(),
+    title: z.string().trim().min(1, 'Give the item a title.'),
+    body: z.string().optional(),
+    bodyFile: z.string().optional(),
+    route: z.string().optional(),
+    locale: z.string().optional(),
+});
+export const FabricChangesFileOutput = z.object({
+    change: z.any(),
+});
+/**
+ * An item filed from a terminal carries no screenshot, no circled elements and
+ * no build — the panel supplies those and nothing here can invent them. What it
+ * does carry is the words, which the skill already treats as the requirement
+ * and every other address as evidence, so a written item is a thinner but not a
+ * malformed one.
+ *
+ * `--body-file` because a real item's body is a paragraph with newlines in it,
+ * and putting that through shell quoting is where it gets mangled.
+ */
+export const FabricChangesFile = pikkuSessionlessFunc({
+    description: 'File a change against a stage from outside the panel.',
+    input: FabricChangesFileInput,
+    output: FabricChangesFileOutput,
+    func: async (_services, input) => {
+        if (input.body && input.bodyFile)
+            throw new Error('Pass --body or --body-file, not both.');
+        const { rpc, projectId } = await changesContext(input.apiUrl, input.projectId);
+        const stageId = input.stageId ??
+            (await resolveStageId(rpc, requireProjectId(projectId), input.branch));
+        const body = input.bodyFile
+            ? await readFile(input.bodyFile, 'utf8')
+            : input.body;
+        return await rpc.invoke('createChange', {
+            stageId,
+            title: input.title,
+            body: body?.trim() || undefined,
+            route: input.route,
+            locale: input.locale,
+        });
+    },
+});
+export const renderChangesFile = (_s, { change }) => {
+    console.log(`Filed #${safe(change.shortId)}  ${safe(change.title)}`);
+    console.log(dim(`  ${safe(change.changeId)}`));
+};