@mccaskie-labs/workbench-config 0.2.5 → 0.3.1

package/dist/capability-schema.js

@@ -26,6 +26,7 @@ export const COMPONENTS = [
     "ui",
     "forms",
     "sign-in",
+    "availability",
 ];
 const id = z.string().regex(/^[a-z0-9][a-z0-9.-]*$/, "lower case, digits, dots and hyphens");
 const code = z.string().regex(/^[a-z][a-z0-9_]*$/, "a snake_case error code");
@@ -203,8 +204,6 @@ const delivery = z.strictObject({
     choice: z.enum(["built_in", "optional"]),
     /** One plain sentence for the owner, shown when Claude introduces the tools. */
     intro: z.string().min(1).max(160),
-    /** When the tool applies, in the client's words. Only for a component with no `offer`, whose `offer.when` says it. */
-    when: z.string().min(1).optional(),
 });
 const baseShape = {
     $schema: z.literal("./schema.json"),
@@ -262,12 +261,6 @@ export const capabilitySchema = z.strictObject(baseShape).superRefine((m, ctx) =
         }
     }
 });
-/**
- * Components whose client questions are still being written (Robert,
- * 11 November 2026: every shared tool ships its questions). The list only
- * shrinks; a new component can't join it.
- */
-export const OFFER_PENDING = ["database", "email", "email-inbound", "strings"];
 function checkOffer(file, component, o, seen) {
     const problems = [];
     const named = new Map();
@@ -381,21 +374,14 @@ export function checkManifests(files) {
             problems.push(...checkOffer(file, m.component, m.offer, seen));
         if (m.offer && m.no_offer)
             problems.push({ file, check: "schema", message: "has both offer and no_offer" });
-        const pending = OFFER_PENDING.includes(m.component);
-        if (!m.offer && !m.no_offer && !pending) {
+        if (!m.offer && !m.no_offer) {
             problems.push({ file, check: "schema", message: "every component ships its client questions: add an offer, or no_offer with the reason a client has nothing to answer" });
         }
-        if ((m.offer || m.no_offer) && pending)
-            problems.push({ file, check: "schema", message: `remove ${m.component} from OFFER_PENDING` });
         // §9.6: every component a client's Claude Code works with says how it reaches the project.
         if (m.no_offer && m.delivery)
             problems.push({ file, check: "schema", message: "has both no_offer and delivery: plumbing gets no skill of its own" });
         if (!m.no_offer && !m.delivery)
             problems.push({ file, check: "schema", message: "add delivery: whether the tool is built in or optional, and one sentence that introduces it to the owner" });
-        if (m.delivery && m.offer && m.delivery.when)
-            problems.push({ file, check: "schema", message: "delivery.when repeats offer.when: remove it" });
-        if (m.delivery && !m.offer && !m.delivery.when)
-            problems.push({ file, check: "schema", message: "delivery needs when, because there is no offer to say when the tool applies" });
     }
     const byComponent = new Map(manifests.map((m) => [m.component, m]));
     for (const { file, m, own } of deferred) {

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { WORKBENCH_ENVS, workbenchEnv, type WorkbenchEnv } from "./env.ts";
 export { defineConfig, type Config } from "./define-config.ts";
 export { sharedSecret, workerSecret, redact, redactAll, type SecretsStoreSecretLike } from "./secrets.ts";
 export { WorkbenchConfigError, type ConfigErrorCode, type ConfigProblem } from "./errors.ts";
-export { capabilitySchema, checkManifests, allowedSchemas, COMPONENTS, type Capability, type Component, type ManifestProblem, type Offer, OFFER_PATTERNS, OFFER_PENDING, } from "./capability-schema.ts";
+export { capabilitySchema, checkManifests, allowedSchemas, COMPONENTS, type Capability, type Component, type ManifestProblem, type Offer, OFFER_PATTERNS, } from "./capability-schema.ts";
 export { projectNotes, renderSkill, renderSkills, renderStart, skillName, SKILLS_DIR, START_SKILL, TOOLS_FILE } from "./skills.ts";
 export { toolsState } from "./tools.ts";
 export type { ToolChoices, ToolsState } from "./tools.ts";

package/dist/index.js

@@ -2,7 +2,7 @@ export { WORKBENCH_ENVS, workbenchEnv } from "./env.js";
 export { defineConfig } from "./define-config.js";
 export { sharedSecret, workerSecret, redact, redactAll } from "./secrets.js";
 export { WorkbenchConfigError } from "./errors.js";
-export { capabilitySchema, checkManifests, allowedSchemas, COMPONENTS, OFFER_PATTERNS, OFFER_PENDING, } from "./capability-schema.js";
+export { capabilitySchema, checkManifests, allowedSchemas, COMPONENTS, OFFER_PATTERNS, } from "./capability-schema.js";
 export { projectNotes, renderSkill, renderSkills, renderStart, skillName, SKILLS_DIR, START_SKILL, TOOLS_FILE } from "./skills.js";
 export { toolsState } from "./tools.js";
 export { capabilities, MANIFEST_VERSION } from "./capabilities.gen.js";

package/dist/skills.d.ts

@@ -6,7 +6,7 @@ export declare const TOOLS_FILE = "workbench/tools.json";
 export declare const START_SKILL = "workbench-start";
 /** The project's own notes on a tool, beside its generated skill: where this project wires it in. Never generated. */
 export declare const projectNotes: (component: string) => string;
-/** The SKILL.md for one manifest, or undefined when it has no `delivery` (plumbing). `guide` is its `capabilities/<component>.md`, when there is one. */
+/** The SKILL.md for one manifest, or undefined for plumbing (no `delivery` or no `offer`). `guide` is its `capabilities/<component>.md`, when there is one. */
 export declare function renderSkill(m: Capability, guide?: string): string | undefined;
 /** The `workbench-start` skill: every tool introduced to the owner, and how their choices are recorded (§9.6). */
 export declare function renderStart(manifests: readonly Capability[]): string;

package/dist/skills.js

@@ -120,14 +120,14 @@ function useBlock(m, guide) {
     out.push(`Read \`${projectNotes(m.component)}\` next, if it is there: it is this project's own note on where the tool is already wired in and how to call it here. It is the project's to edit; add to it when the wiring changes. Its limits, rules and error codes are in ${manifest}, and each package's API is in its \`README.md\` under \`node_modules/@mccaskie-labs/\`.`);
     return out;
 }
-/** The SKILL.md for one manifest, or undefined when it has no `delivery` (plumbing). `guide` is its `capabilities/<component>.md`, when there is one. */
+/** The SKILL.md for one manifest, or undefined for plumbing (no `delivery` or no `offer`). `guide` is its `capabilities/<component>.md`, when there is one. */
 export function renderSkill(m, guide) {
     const o = m.offer;
     const d = m.delivery;
-    if (!d)
+    if (!d || !o)
         return undefined;
-    const when = o?.when ?? d.when ?? m.summary;
-    const description = (o ? `${when} Offers Workbench ${m.title} and asks the client for its settings.` : `${when} Use Workbench ${m.title} for it.`).replaceAll("\n", " ");
+    const when = o.when;
+    const description = `${when} Offers Workbench ${m.title} and asks the client for its settings.`.replaceAll("\n", " ");
     const out = [
         "---",
         `name: ${skillName(m.component)}`,
@@ -146,10 +146,6 @@ export function renderSkill(m, guide) {
         "",
         ...beforeBlock(m),
     ];
-    if (!o) {
-        out.push("", "## Questions", "", "This tool's questions for the client aren't written yet. Use it with its defaults, tell the client that is what you did, and invent no setting. A choice only the client can make goes to them as a plain question.", ...(m.styles ? ["", "## Restyling", "", restyleLine(m.styles.prefix)] : []), "", ...useBlock(m, guide));
-        return `${out.join("\n")}\n`;
-    }
     out.push("", "## What to say", "", d.choice === "optional"
         ? `Once the owner's choice is yes, say: "${o.say}"`
         : `Say: "${o.say}" Don't ask whether to use Workbench or something of the client's own. If the client says they don't want it, stop and say what they give up.`, "", "## How to ask", "", ...(o.needs?.length ? [`- First check the project setup this needs: ${o.needs.map((n) => `\`workbench/${n}.json\``).join(", ")}. If one is missing, use that component's \`workbench-<component>\` skill first.`] : []), ...PATTERN_STEPS[o.pattern].map((step) => `- ${step}`), "- Ask with the AskUserQuestion tool, up to four questions per call. Give each question's answers in the order below; the first is recommended, so label it \"(Recommended)\", unless the question says none is. The tool adds \"Other\" itself.", "- Where the client accepts every recommendation, still ask each \"Must ask\" question.", "- An \"Other\" answer must meet the rule under its question. When it doesn't, say why and ask again. Never store a value outside it.", "- Ask nothing that isn't listed here, and invent no setting. A need the questions don't cover goes back to the client as a plain question, and isn't written to the answers file.", `- Write the answers to \`${o.answers_file}\`${o.per ? `, one entry per ${o.per}` : ""}: ${o.answers_format ?? `for each question its id, the value, and the client's own words when they typed "Other" or changed a recommendation.`}${o.generator ? ` Then run \`${o.generator}\`, which writes the code and refuses anything the package can't apply (it doesn't check the "Other" rules: you do). It builds nothing while an answers file is a draft. Never edit what it writes; change the answers file and run it again.` : ""}`, "", "## Questions", "", o.questions.map((q, i) => questionBlock(q, i + 1)).join("\n\n"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mccaskie-labs/workbench-config",
-  "version": "0.2.5",
+  "version": "0.3.1",
   "description": "Workbench app configuration: WORKBENCH_ENV, typed variables that fail by name, secrets that are never printed, and the capabilities manifest.",
   "license": "UNLICENSED",
   "type": "module",