@owlmeans/viable-common 0.0.4

package/build/scaffold/types.d.ts

@@ -0,0 +1,144 @@
+import type { ProjectArea } from '../areas/consts.js';
+import type { WidgetKind } from './consts.js';
+/**
+ * The placeholder content of one drawn widget.
+ *
+ * Structured rather than free text because the scaffold STAMPS these into code without a model:
+ * a paragraph describing a table cannot be turned into columns deterministically, a list of
+ * column names can.
+ */
+export interface SketchContent {
+    /** The heading the placeholder carries. */
+    headline: string;
+    /** One line under it saying what the finished thing will show. */
+    caption: string;
+    /** Example rows, for a list. */
+    items?: string[];
+    /** Column names, for a table. */
+    columns?: string[];
+    /** Field labels, for a form. */
+    fields?: string[];
+    /** Bars, for a chart — `value` is a 0..100 magnitude, not real data. */
+    series?: {
+        label: string;
+        value: number;
+    }[];
+    /** Figures, for a summary. */
+    stats?: {
+        label: string;
+        value: string;
+    }[];
+}
+/** What the scaffold draws for one user story. */
+export interface ScaffoldStoryPlan {
+    /** The story's code — always one of the codes the planner was given. */
+    code: string;
+    /** The top-menu section, inside the story's own area, this story belongs to. */
+    section: string;
+    /** The screen name the story's implementation should adopt: `{section}/{purpose}`. */
+    screen: string;
+    /** The dashboard widget this story owns. */
+    widget: {
+        kind: WidgetKind;
+        title: string;
+        description: string;
+    };
+    /** What the placeholder shows until the story is implemented. */
+    sketch: SketchContent;
+    /** Whether this widget is important enough to also appear on its area's home screen. */
+    home: boolean;
+    /**
+     * The story whose preview this one renders instead of drawing its own.
+     *
+     * A pure OPTIMIZATION hint, and every consumer treats it as untrusted: absent, dropped, or
+     * naming a code that is not in the plan, the story falls back to owning its own widget and the
+     * drawn tree is exactly what it is today. It exists because a main flow's consecutive steps act
+     * on the SAME record through the same shape, and drawing a near-duplicate form for each one
+     * fills an area with previews that differ only in their heading.
+     *
+     * The arrow points at the OWNER, and only ever backwards in plan order — `fillScaffoldPlan`
+     * resolves and clamps it, so nothing downstream has to reason about cycles or forward
+     * references.
+     */
+    sharesWidgetWith?: string;
+    /**
+     * The story whose SCREEN this one renders instead of drawing its own.
+     *
+     * Same rules and the same clamp as {@link sharesWidgetWith}, and deliberately a separate field:
+     * two steps can want one form on one screen, or one form reached from two screens, and
+     * collapsing both decisions into one flag makes the second unexpressible.
+     */
+    sharesScreenWith?: string;
+}
+/** One area's shape: how its top menu is divided, and how it introduces itself. */
+export interface ScaffoldAreaPlan {
+    area: ProjectArea;
+    /** The introduction widget on the area's home screen. */
+    intro: {
+        title: string;
+        text: string;
+    };
+    /** The top-menu sections of this area, in menu order. */
+    sections: string[];
+}
+/**
+ * What the application calls itself, everywhere a machine reads it.
+ *
+ * Not branding and not decoration: this is what the document's `<title>`, its description and its
+ * icon are built from. The one page an anonymous visitor can reach is a sign-in page, served from
+ * a machine-generated hostname — and a sign-in page carrying no title, no description and no icon
+ * is the exact shape Safe Browsing scores as credential phishing. A generated application that
+ * never replaced the template's placeholder ships that shape by default, so the identity is
+ * planned here and stamped like every other part of the scaffold.
+ */
+export interface ProductIdentity {
+    /** The product's own name, as a person reads it. Never a slug, never a placeholder. */
+    name: string;
+    /** One sentence saying what the product is, for `<meta name="description">`. */
+    description: string;
+}
+/** The guest area's landing page — the product's public face. */
+export interface GuestHomePlan {
+    hero: {
+        eyebrow: string;
+        headline: string;
+        sub: string;
+        cta: string;
+    };
+    problem: {
+        title: string;
+        text: string;
+    };
+    solution: {
+        title: string;
+        text: string;
+    };
+    features: {
+        title: string;
+        text: string;
+    }[];
+    testimonials: {
+        quote: string;
+        name: string;
+        role: string;
+    }[];
+}
+/**
+ * Everything one cheap call decides about a project's scaffolding.
+ *
+ * It is a PLAN, never code: the stamping that turns it into screens, widgets and dashboards is
+ * deterministic, so the same plan always produces the same tree and a re-scaffold is idempotent.
+ */
+export interface ScaffoldPlan {
+    /** What this application is called and what it says it is. */
+    identity: ProductIdentity;
+    guestHome: GuestHomePlan;
+    areas: ScaffoldAreaPlan[];
+    stories: ScaffoldStoryPlan[];
+    /**
+     * How this product's illustrations should look — geometry and motif, in the design system's
+     * own vocabulary. The one field here that is prose, because it is read by a model.
+     */
+    motifs: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/scaffold/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scaffold/types.ts"],"names":[],"mappings":"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"}

package/build/scaffold/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/scaffold/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scaffold/types.ts"],"names":[],"mappings":""}

package/build/skills/catalogue.d.ts

@@ -0,0 +1,47 @@
+import type { SkillDefinition } from '@owlmeans/llm-common';
+import { ViableSkill } from './consts.js';
+/** The one rendering of a library allow-list — an override must match it byte for byte. */
+export declare const renderLibraries: (list: string[]) => string;
+/**
+ * What a file in the shared package imports. Deliberately just `ajv`: this list is carried by
+ * `DomainTypesArchitect`/`AccessArchitect` too, and a domain model type file imports nothing
+ * else. `@owlmeans/entrypoint` and `@owlmeans/route` are named by `OwlMeansEntrypoints`
+ * instead — the personas that actually author `entrypoints.ts` carry that skill, and naming a
+ * package pulls its whole published documentation into the prompt.
+ */
+export declare const commonLibraryList: string[];
+export declare const uiStateLibraryList: string[];
+export declare const uiComponentLibraryList: string[];
+/**
+ * Deliberately WITHOUT `drizzle-orm`. This list renders last of all the skills (order 90), so a
+ * package named here is the final instruction a backend persona reads — and it used to say
+ * "use drizzle" directly under `ResourceLayer` saying "never import it". `postgres-resource`
+ * owns drizzle internally (its own dependency; the peers are `pg` and `ajv`), and a target
+ * reaches the builder through the resource, never through an import. Do not re-add it.
+ */
+export declare const backendLibraryList: string[];
+export declare const fullUiLibraryList: string[];
+/**
+ * The backend list plus the two packages that make a model call possible.
+ *
+ * Naming them is what pulls their own published documentation into the prompt, so this list
+ * carries the API contract without this catalogue restating a line of it. It is reachable only
+ * through a blueprint case that also installs them — a coder told about a package the manifest
+ * does not declare writes `TS2307`.
+ */
+export declare const aiLibraryList: string[];
+/**
+ * The UI list plus three.js. Scene code and interface code are the same package and the same
+ * bundle here; what separates them is the component, not the dependency list.
+ */
+export declare const gameLibraryList: string[];
+/**
+ * How an entrypoint alias is spelled. Shared verbatim by the entrypoints skill and by every
+ * helper prompt that asks a model to invent one — two renderings would drift, and the pipeline
+ * splits screen from API access rules on the prefix alone.
+ */
+export declare const ALIAS_CONVENTION: string;
+export declare const VIABLE_SKILLS: SkillDefinition[];
+/** Look one up by alias — for the places that still splice a rule into a task prompt. */
+export declare const viableSkill: (alias: ViableSkill) => SkillDefinition;
+//# sourceMappingURL=catalogue.d.ts.map

package/build/skills/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../src/skills/catalogue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAe,WAAW,EAAE,MAAM,aAAa,CAAA;AAgBtD,2FAA2F;AAC3F,eAAO,MAAM,eAAe,SAAU,MAAM,EAAE,KAAG,MACuC,CAAA;AAKxF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,UAAU,CAAA;AACxC,eAAO,MAAM,kBAAkB,UAE9B,CAAA;AACD,eAAO,MAAM,sBAAsB,UAKlC,CAAA;AACD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,UAE9B,CAAA;AACD,eAAO,MAAM,iBAAiB,UAAmE,CAAA;AAEjG;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,UAEzB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,UAAgD,CAAA;AAE5E;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAarB,CAAA;AAER,eAAO,MAAM,aAAa,EAAE,eAAe,EAi/C1C,CAAA;AAED,yFAAyF;AACzF,eAAO,MAAM,WAAW,UAAW,WAAW,KAAG,eACI,CAAA"}