create-cogenta 0.0.3 → 0.1.0

package/dist/blueprints/documentation.js

@@ -0,0 +1,153 @@
+import { createContentStore, defineCollection, f, validateCollectionSet, } from '@cogenta/schema';
+import { definePageCollection, toBlockZoneEntry, } from './content-pack.js';
+/**
+ * The `documentation` blueprint's content model (L9 task 8, batch A):
+ * reference material, not marketing — the "pages types" are `docPage`
+ * entries themselves (ordered, grouped into sections), rather than a
+ * generic block-composed page for each one. A single `page` entry (`home`)
+ * still exists so the site root works and links into the docs, exactly
+ * like every other blueprint's landing page.
+ */
+export const docPage = defineCollection({
+    name: 'doc_page',
+    labels: { singular: 'Doc page', plural: 'Doc pages' },
+    routing: { pattern: '/docs/:slug' },
+    fields: {
+        title: f.text({ required: true, max: 200 }),
+        slug: f.slug({ from: 'title', unique: true }),
+        section: f.text({ required: true, max: 80 }),
+        order: f.number({ required: true, integer: true, min: 0 }),
+        body: f.blocks({ required: true }),
+    },
+    indexes: [['slug'], ['section']],
+    permissions: {
+        read: ['public'],
+        create: ['editor', 'admin'],
+        update: ['editor', 'admin'],
+        delete: ['admin'],
+    },
+});
+export const page = definePageCollection('/:slug');
+export const DOCUMENTATION_COLLECTIONS = [docPage, page];
+validateCollectionSet(DOCUMENTATION_COLLECTIONS);
+const BLOCK_VERSION = '1.0.0';
+function proseParagraph(key, text) {
+    return {
+        _key: key,
+        _type: 'prose',
+        _version: BLOCK_VERSION,
+        body: [
+            {
+                _key: `${key}-block`,
+                _type: 'block',
+                style: 'normal',
+                children: [{ _key: `${key}-span`, _type: 'span', text, marks: [] }],
+                markDefs: [],
+            },
+        ],
+    };
+}
+export const DOCUMENTATION_DEMO_DOC_PAGES = [
+    {
+        title: 'Getting started',
+        slug: 'getting-started',
+        section: 'Guides',
+        order: 1,
+        body: [
+            proseParagraph('demo-doc-getting-started', 'This is a demo documentation site, scaffolded by create-cogenta from the "documentation" blueprint. Each doc page below was seeded by the installer so there is real content to look at from the first run.'),
+        ],
+    },
+    {
+        title: 'Configuration',
+        slug: 'configuration',
+        section: 'Guides',
+        order: 2,
+        body: [
+            proseParagraph('demo-doc-configuration', 'Doc pages are ordered within a section by the "order" field, and grouped by "section" — both normal, editable fields, not fixed navigation.'),
+        ],
+    },
+    {
+        title: 'API reference',
+        slug: 'api-reference',
+        section: 'Reference',
+        order: 1,
+        body: [
+            proseParagraph('demo-doc-api-reference', 'A separate section from the guides above, so a docs site can hold both narrative and reference material without one crowding out the other.'),
+        ],
+    },
+];
+export const DOCUMENTATION_DEMO_PAGES = [
+    {
+        title: 'Home',
+        slug: 'home',
+        blocks: [
+            {
+                _key: 'demo-home-hero',
+                _type: 'hero',
+                _version: BLOCK_VERSION,
+                eyebrow: 'Documentation',
+                title: 'Everything documented, nothing hidden',
+                subtitle: 'Scaffolded by create-cogenta from the "documentation" blueprint, with real demo doc pages already in place.',
+                actions: [
+                    {
+                        label: 'Start reading',
+                        target: { href: '/docs/getting-started' },
+                        emphasis: 'primary',
+                    },
+                ],
+            },
+            {
+                _key: 'demo-home-docs',
+                _type: 'collectionList',
+                _version: BLOCK_VERSION,
+                title: 'Doc pages',
+                collection: 'doc_page',
+                sort: { field: 'createdAt', direction: 'asc' },
+                limit: 20,
+                layout: 'list',
+            },
+        ],
+    },
+];
+export const DOCUMENTATION_RECOMMENDED_AGENTS = [
+    {
+        name: 'contentAgent',
+        package: '@cogenta/agents-builtin',
+        reason: 'Flags terminology drift across doc pages, where consistent wording matters most.',
+    },
+    {
+        name: 'seoAgent',
+        package: '@cogenta/agents-builtin',
+        reason: 'Audits internal linking between doc pages so readers can navigate without the sidebar.',
+    },
+];
+/**
+ * Inserts the `documentation` blueprint's demo content through the real
+ * `ContentStore` — never mocked (house rule).
+ */
+async function seedDocumentationDemoContent(db, defaultLocale, adminId) {
+    const docPageStore = createContentStore({ db, collection: docPage, defaultLocale });
+    const pageStore = createContentStore({ db, collection: page, defaultLocale });
+    for (const demo of DOCUMENTATION_DEMO_DOC_PAGES) {
+        await docPageStore.create({
+            status: 'published',
+            createdBy: adminId,
+            values: { title: demo.title, slug: demo.slug, section: demo.section, order: demo.order },
+            blocks: { body: demo.body.map(toBlockZoneEntry) },
+        });
+    }
+    for (const demo of DOCUMENTATION_DEMO_PAGES) {
+        await pageStore.create({
+            status: 'published',
+            createdBy: adminId,
+            values: { title: demo.title, slug: demo.slug },
+            blocks: { blocks: demo.blocks.map(toBlockZoneEntry) },
+        });
+    }
+}
+export const documentationContentPack = {
+    collections: DOCUMENTATION_COLLECTIONS,
+    recommendedAgents: DOCUMENTATION_RECOMMENDED_AGENTS,
+    seedDemoContent: seedDocumentationDemoContent,
+};
+//# sourceMappingURL=documentation.js.map

package/dist/blueprints/documentation.js.map

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

package/dist/blueprints/magazine.d.ts

@@ -0,0 +1,79 @@
+import type { VocabularyBlock } from '@cogenta/blocks';
+import { type CollectionDefinition } from '@cogenta/schema';
+import { type BlueprintContentPack, type RecommendedAgentHint } from './content-pack.js';
+/**
+ * The `magazine` blueprint's content model (L9 task 8, batch B): editorial
+ * content grouped into sections — one collection (`article`), one grouping
+ * field (`section`), rather than a separate category collection on top of
+ * it (`blog` already covers the "posts plus a real category collection"
+ * shape; a magazine's twist is section-grouped editorial, not another
+ * taxonomy).
+ */
+export declare const article: {
+    readonly name: "article";
+    readonly labels: {
+        readonly singular: "Article";
+        readonly plural: "Articles";
+    };
+    readonly routing: {
+        readonly pattern: "/articles/:slug";
+    };
+    readonly fields: {
+        title: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        slug: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "slug";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        excerpt: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        section: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "select";
+            readonly options: {
+                options: readonly import("@cogenta/schema").SelectChoice[];
+                many: boolean;
+            };
+        };
+        body: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "blocks";
+            readonly options: {
+                allow: "*" | readonly string[];
+            };
+        };
+    };
+    readonly indexes: readonly [readonly ["slug"], readonly ["section"]];
+    readonly permissions: {
+        readonly read: readonly ["public"];
+        readonly create: readonly ["editor", "admin"];
+        readonly update: readonly ["editor", "admin"];
+        readonly delete: readonly ["admin"];
+        readonly publish: readonly ["admin"];
+    };
+};
+export declare const page: CollectionDefinition;
+export declare const MAGAZINE_COLLECTIONS: readonly CollectionDefinition[];
+export interface MagazineDemoArticle {
+    readonly title: string;
+    readonly slug: string;
+    readonly excerpt: string;
+    readonly section: 'News' | 'Culture' | 'Opinion';
+    readonly body: readonly VocabularyBlock[];
+}
+export declare const MAGAZINE_DEMO_ARTICLES: readonly MagazineDemoArticle[];
+export interface MagazineDemoPage {
+    readonly title: string;
+    readonly slug: string;
+    readonly blocks: readonly VocabularyBlock[];
+}
+/**
+ * `home` (hero + a live list of recent articles) and `about` (a short prose
+ * masthead note).
+ */
+export declare const MAGAZINE_DEMO_PAGES: readonly MagazineDemoPage[];
+export declare const MAGAZINE_RECOMMENDED_AGENTS: readonly RecommendedAgentHint[];
+export declare const magazineContentPack: BlueprintContentPack;
+//# sourceMappingURL=magazine.d.ts.map

package/dist/blueprints/magazine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magazine.d.ts","sourceRoot":"","sources":["../../src/blueprints/magazine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,EACL,KAAK,oBAAoB,EAK1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAE1B,MAAM,mBAAmB,CAAA;AAE1B;;;;;;;GAOG;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;QAKhB,KAAK;;;;QACL,IAAI;;;;QACJ,OAAO;;;;QACP,OAAO;;;;;;;QACP,IAAI;;;;;;;;;;;;;;;CAUN,CAAA;AAEF,eAAO,MAAM,IAAI,sBAAiC,CAAA;AAElD,eAAO,MAAM,oBAAoB,EAAE,SAAS,oBAAoB,EAAoB,CAAA;AAuBpF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1C;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAqChE,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;CAC5C;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAoC1D,CAAA;AAED,eAAO,MAAM,2BAA2B,EAAE,SAAS,oBAAoB,EAWtE,CAAA;AAsCD,eAAO,MAAM,mBAAmB,EAAE,oBAIjC,CAAA"}

package/dist/blueprints/magazine.js

@@ -0,0 +1,163 @@
+import { createContentStore, defineCollection, f, validateCollectionSet, } from '@cogenta/schema';
+import { definePageCollection, toBlockZoneEntry, } from './content-pack.js';
+/**
+ * The `magazine` blueprint's content model (L9 task 8, batch B): editorial
+ * content grouped into sections — one collection (`article`), one grouping
+ * field (`section`), rather than a separate category collection on top of
+ * it (`blog` already covers the "posts plus a real category collection"
+ * shape; a magazine's twist is section-grouped editorial, not another
+ * taxonomy).
+ */
+export const article = defineCollection({
+    name: 'article',
+    labels: { singular: 'Article', plural: 'Articles' },
+    routing: { pattern: '/articles/:slug' },
+    fields: {
+        title: f.text({ required: true, max: 200 }),
+        slug: f.slug({ from: 'title', unique: true }),
+        excerpt: f.text({ max: 300, multiline: true }),
+        section: f.select({ options: ['News', 'Culture', 'Opinion'], required: true }),
+        body: f.blocks({ required: true }),
+    },
+    indexes: [['slug'], ['section']],
+    permissions: {
+        read: ['public'],
+        create: ['editor', 'admin'],
+        update: ['editor', 'admin'],
+        delete: ['admin'],
+        publish: ['admin'],
+    },
+});
+export const page = definePageCollection('/:slug');
+export const MAGAZINE_COLLECTIONS = [article, page];
+validateCollectionSet(MAGAZINE_COLLECTIONS);
+const BLOCK_VERSION = '1.0.0';
+function proseParagraph(key, text) {
+    return {
+        _key: key,
+        _type: 'prose',
+        _version: BLOCK_VERSION,
+        body: [
+            {
+                _key: `${key}-block`,
+                _type: 'block',
+                style: 'normal',
+                children: [{ _key: `${key}-span`, _type: 'span', text, marks: [] }],
+                markDefs: [],
+            },
+        ],
+    };
+}
+export const MAGAZINE_DEMO_ARTICLES = [
+    {
+        title: 'A new season, a new lineup',
+        slug: 'a-new-season-a-new-lineup',
+        excerpt: 'What changed this quarter, and why it matters to readers.',
+        section: 'News',
+        body: [
+            proseParagraph('demo-article-1-p1', 'This is a demo magazine, scaffolded by create-cogenta from the "magazine" blueprint. Its articles were seeded by the installer so there is real content to look at from the first run.'),
+        ],
+    },
+    {
+        title: 'Three exhibitions worth the trip',
+        slug: 'three-exhibitions-worth-the-trip',
+        excerpt: 'A short, opinionated guide to what is showing this month.',
+        section: 'Culture',
+        body: [
+            proseParagraph('demo-article-2-p1', 'Articles are grouped by "section", a normal editable field, not a fixed navigation menu.'),
+        ],
+    },
+    {
+        title: 'Why the small stories matter most',
+        slug: 'why-the-small-stories-matter-most',
+        excerpt: "An editor's take on what gets left out of the bigger headlines.",
+        section: 'Opinion',
+        body: [
+            proseParagraph('demo-article-3-p1', 'Everything here — the schema, the content, the skin — is a normal part of the site and is meant to be edited, renamed or deleted the moment the defaults stop fitting.'),
+        ],
+    },
+];
+/**
+ * `home` (hero + a live list of recent articles) and `about` (a short prose
+ * masthead note).
+ */
+export const MAGAZINE_DEMO_PAGES = [
+    {
+        title: 'Home',
+        slug: 'home',
+        blocks: [
+            {
+                _key: 'demo-home-hero',
+                _type: 'hero',
+                _version: BLOCK_VERSION,
+                eyebrow: 'Magazine',
+                title: 'Stories worth your time',
+                subtitle: 'Scaffolded by create-cogenta from the "magazine" blueprint, with real demo articles already in place.',
+            },
+            {
+                _key: 'demo-home-articles',
+                _type: 'collectionList',
+                _version: BLOCK_VERSION,
+                title: 'Latest articles',
+                collection: 'article',
+                sort: { field: 'createdAt', direction: 'desc' },
+                limit: 10,
+                layout: 'list',
+            },
+        ],
+    },
+    {
+        title: 'About',
+        slug: 'about',
+        blocks: [
+            proseParagraph('demo-about-prose', 'This is a demo magazine, scaffolded by create-cogenta from the "magazine" blueprint. Its articles and this page were seeded by the installer so there is real content to look at from the first run.'),
+        ],
+    },
+];
+export const MAGAZINE_RECOMMENDED_AGENTS = [
+    {
+        name: 'contentAgent',
+        package: '@cogenta/agents-builtin',
+        reason: 'Flags terminology drift and topic gaps across sections written by different editors.',
+    },
+    {
+        name: 'seoAgent',
+        package: '@cogenta/agents-builtin',
+        reason: 'Audits published articles for on-page SEO issues and internal-linking gaps.',
+    },
+];
+/**
+ * Inserts the `magazine` blueprint's demo content through the real
+ * `ContentStore` — never mocked (house rule).
+ */
+async function seedMagazineDemoContent(db, defaultLocale, adminId) {
+    const articleStore = createContentStore({ db, collection: article, defaultLocale });
+    const pageStore = createContentStore({ db, collection: page, defaultLocale });
+    for (const demo of MAGAZINE_DEMO_ARTICLES) {
+        await articleStore.create({
+            status: 'published',
+            createdBy: adminId,
+            values: {
+                title: demo.title,
+                slug: demo.slug,
+                excerpt: demo.excerpt,
+                section: demo.section,
+            },
+            blocks: { body: demo.body.map(toBlockZoneEntry) },
+        });
+    }
+    for (const demo of MAGAZINE_DEMO_PAGES) {
+        await pageStore.create({
+            status: 'published',
+            createdBy: adminId,
+            values: { title: demo.title, slug: demo.slug },
+            blocks: { blocks: demo.blocks.map(toBlockZoneEntry) },
+        });
+    }
+}
+export const magazineContentPack = {
+    collections: MAGAZINE_COLLECTIONS,
+    recommendedAgents: MAGAZINE_RECOMMENDED_AGENTS,
+    seedDemoContent: seedMagazineDemoContent,
+};
+//# sourceMappingURL=magazine.js.map

package/dist/blueprints/magazine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"magazine.js","sourceRoot":"","sources":["../../src/blueprints/magazine.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,kBAAkB,EAClB,gBAAgB,EAChB,CAAC,EACD,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAEL,oBAAoB,EAEpB,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAE1B;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC;IACtC,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE;IACnD,OAAO,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE;IACvC,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC3C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC7C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC9E,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KACnC;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IAChC,WAAW,EAAE;QACX,IAAI,EAAE,CAAC,QAAQ,CAAC;QAChB,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,MAAM,EAAE,CAAC,OAAO,CAAC;QACjB,OAAO,EAAE,CAAC,OAAO,CAAC;KACnB;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAA;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAoC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AAEpF,qBAAqB,CAAC,oBAAoB,CAAC,CAAA;AAE3C,MAAM,aAAa,GAAG,OAAO,CAAA;AAE7B,SAAS,cAAc,CAAC,GAAW,EAAE,IAAY;IAC/C,OAAO;QACL,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE,GAAG,GAAG,QAAQ;gBACpB,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;gBACnE,QAAQ,EAAE,EAAE;aACb;SACF;KACiB,CAAA;AACtB,CAAC;AAUD,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE;QACE,KAAK,EAAE,4BAA4B;QACnC,IAAI,EAAE,2BAA2B;QACjC,OAAO,EAAE,2DAA2D;QACpE,OAAO,EAAE,MAAM;QACf,IAAI,EAAE;YACJ,cAAc,CACZ,mBAAmB,EACnB,wLAAwL,CACzL;SACF;KACF;IACD;QACE,KAAK,EAAE,kCAAkC;QACzC,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,2DAA2D;QACpE,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE;YACJ,cAAc,CACZ,mBAAmB,EACnB,0FAA0F,CAC3F;SACF;KACF;IACD;QACE,KAAK,EAAE,mCAAmC;QAC1C,IAAI,EAAE,mCAAmC;QACzC,OAAO,EAAE,iEAAiE;QAC1E,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE;YACJ,cAAc,CACZ,mBAAmB,EACnB,wKAAwK,CACzK;SACF;KACF;CACF,CAAA;AAQD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D;QACE,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,aAAa;gBACvB,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE,yBAAyB;gBAChC,QAAQ,EACN,uGAAuG;aAC1G;YACD;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,KAAK,EAAE,gBAAgB;gBACvB,QAAQ,EAAE,aAAa;gBACvB,KAAK,EAAE,iBAAiB;gBACxB,UAAU,EAAE,SAAS;gBACrB,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE;gBAC/C,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,MAAM;aACf;SACF;KACF;IACD;QACE,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,OAAO;QACb,MAAM,EAAE;YACN,cAAc,CACZ,kBAAkB,EAClB,sMAAsM,CACvM;SACF;KACF;CACF,CAAA;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAoC;IAC1E;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,yBAAyB;QAClC,MAAM,EAAE,sFAAsF;KAC/F;IACD;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,yBAAyB;QAClC,MAAM,EAAE,6EAA6E;KACtF;CACF,CAAA;AAED;;;GAGG;AACH,KAAK,UAAU,uBAAuB,CACpC,EAAkB,EAClB,aAAqB,EACrB,OAAsB;IAEtB,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAA;IACnF,MAAM,SAAS,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;IAE7E,KAAK,MAAM,IAAI,IAAI,sBAAsB,EAAE,CAAC;QAC1C,MAAM,YAAY,CAAC,MAAM,CAAC;YACxB,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,OAAO;YAClB,MAAM,EAAE;gBACN,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE;SAClD,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,MAAM,SAAS,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,OAAO;YAClB,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YAC9C,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE;SACtD,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAyB;IACvD,WAAW,EAAE,oBAAoB;IACjC,iBAAiB,EAAE,2BAA2B;IAC9C,eAAe,EAAE,uBAAuB;CACzC,CAAA"}

package/dist/blueprints/portfolio.d.ts

@@ -0,0 +1,73 @@
+import type { VocabularyBlock } from '@cogenta/blocks';
+import { type CollectionDefinition } from '@cogenta/schema';
+import { type BlueprintContentPack, type RecommendedAgentHint } from './content-pack.js';
+/**
+ * The `portfolio` blueprint's content model (L9 task 8, batch A): a
+ * freelance/creative portfolio — a `project` collection with its own
+ * routed page, and two demo pages.
+ */
+export declare const project: {
+    readonly name: "project";
+    readonly labels: {
+        readonly singular: "Project";
+        readonly plural: "Projects";
+    };
+    readonly routing: {
+        readonly pattern: "/work/:slug";
+    };
+    readonly fields: {
+        title: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        slug: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "slug";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        summary: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        role: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+        year: import("@cogenta/schema").FieldDefinition & {
+            readonly kind: "text";
+            readonly options: Readonly<Record<string, unknown>>;
+        };
+    };
+    readonly indexes: readonly [readonly ["slug"]];
+    readonly permissions: {
+        readonly read: readonly ["public"];
+        readonly create: readonly ["editor", "admin"];
+        readonly update: readonly ["editor", "admin"];
+        readonly delete: readonly ["admin"];
+        readonly publish: readonly ["admin"];
+    };
+};
+export declare const page: CollectionDefinition;
+export declare const PORTFOLIO_COLLECTIONS: readonly CollectionDefinition[];
+export interface PortfolioDemoProject {
+    readonly title: string;
+    readonly slug: string;
+    readonly summary: string;
+    readonly role: string;
+    readonly year: string;
+}
+export declare const PORTFOLIO_DEMO_PROJECTS: readonly PortfolioDemoProject[];
+export interface PortfolioDemoPage {
+    readonly title: string;
+    readonly slug: string;
+    readonly blocks: readonly VocabularyBlock[];
+}
+/**
+ * `home` (hero + a live grid of projects) and `about` (a short prose bio
+ * plus a static `stats` summary — years of experience and projects
+ * delivered are page-authored numbers, not something to model as a
+ * separate queryable collection).
+ */
+export declare const PORTFOLIO_DEMO_PAGES: readonly PortfolioDemoPage[];
+export declare const PORTFOLIO_RECOMMENDED_AGENTS: readonly RecommendedAgentHint[];
+export declare const portfolioContentPack: BlueprintContentPack;
+//# sourceMappingURL=portfolio.d.ts.map

package/dist/blueprints/portfolio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.d.ts","sourceRoot":"","sources":["../../src/blueprints/portfolio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,EACL,KAAK,oBAAoB,EAK1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAE1B,MAAM,mBAAmB,CAAA;AAE1B;;;;GAIG;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;QAKhB,KAAK;;;;QACL,IAAI;;;;QACJ,OAAO;;;;QACP,IAAI;;;;QACJ,IAAI;;;;;;;;;;;;;CAUN,CAAA;AAEF,eAAO,MAAM,IAAI,sBAAiC,CAAA;AAElD,eAAO,MAAM,qBAAqB,EAAE,SAAS,oBAAoB,EAAoB,CAAA;AAIrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EAwBlE,CAAA;AAID,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;CAC5C;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAgE5D,CAAA;AAED,eAAO,MAAM,4BAA4B,EAAE,SAAS,oBAAoB,EAWvE,CAAA;AAsCD,eAAO,MAAM,oBAAoB,EAAE,oBAIlC,CAAA"}

package/dist/blueprints/portfolio.js

@@ -0,0 +1,171 @@
+import { createContentStore, defineCollection, f, validateCollectionSet, } from '@cogenta/schema';
+import { definePageCollection, toBlockZoneEntry, } from './content-pack.js';
+/**
+ * The `portfolio` blueprint's content model (L9 task 8, batch A): a
+ * freelance/creative portfolio — a `project` collection with its own
+ * routed page, and two demo pages.
+ */
+export const project = defineCollection({
+    name: 'project',
+    labels: { singular: 'Project', plural: 'Projects' },
+    routing: { pattern: '/work/:slug' },
+    fields: {
+        title: f.text({ required: true, max: 200 }),
+        slug: f.slug({ from: 'title', unique: true }),
+        summary: f.text({ max: 300, multiline: true }),
+        role: f.text({ max: 120 }),
+        year: f.text({ max: 4 }),
+    },
+    indexes: [['slug']],
+    permissions: {
+        read: ['public'],
+        create: ['editor', 'admin'],
+        update: ['editor', 'admin'],
+        delete: ['admin'],
+        publish: ['admin'],
+    },
+});
+export const page = definePageCollection('/:slug');
+export const PORTFOLIO_COLLECTIONS = [project, page];
+validateCollectionSet(PORTFOLIO_COLLECTIONS);
+export const PORTFOLIO_DEMO_PROJECTS = [
+    {
+        title: 'Northwind rebrand',
+        slug: 'northwind-rebrand',
+        summary: 'A full visual identity refresh for a regional grocery chain, from logotype to packaging.',
+        role: 'Art direction',
+        year: '2025',
+    },
+    {
+        title: 'Contoso mobile app',
+        slug: 'contoso-mobile-app',
+        summary: 'Interaction design and a component library for a fintech app used by two million people.',
+        role: 'Product design',
+        year: '2024',
+    },
+    {
+        title: 'Fabrikam annual report',
+        slug: 'fabrikam-annual-report',
+        summary: 'Editorial design for a 60-page annual report, printed and interactive.',
+        role: 'Editorial design',
+        year: '2023',
+    },
+];
+const BLOCK_VERSION = '1.0.0';
+/**
+ * `home` (hero + a live grid of projects) and `about` (a short prose bio
+ * plus a static `stats` summary — years of experience and projects
+ * delivered are page-authored numbers, not something to model as a
+ * separate queryable collection).
+ */
+export const PORTFOLIO_DEMO_PAGES = [
+    {
+        title: 'Home',
+        slug: 'home',
+        blocks: [
+            {
+                _key: 'demo-home-hero',
+                _type: 'hero',
+                _version: BLOCK_VERSION,
+                eyebrow: 'Portfolio',
+                title: 'Selected work',
+                subtitle: 'Scaffolded by create-cogenta from the "portfolio" blueprint, with real demo projects already in place.',
+            },
+            {
+                _key: 'demo-home-projects',
+                _type: 'collectionList',
+                _version: BLOCK_VERSION,
+                title: 'Projects',
+                collection: 'project',
+                sort: { field: 'createdAt', direction: 'desc' },
+                limit: 10,
+                layout: 'grid',
+            },
+        ],
+    },
+    {
+        title: 'About',
+        slug: 'about',
+        blocks: [
+            {
+                _key: 'demo-about-prose',
+                _type: 'prose',
+                _version: BLOCK_VERSION,
+                body: [
+                    {
+                        _key: 'demo-about-p1',
+                        _type: 'block',
+                        style: 'normal',
+                        children: [
+                            {
+                                _key: 'demo-about-p1-span',
+                                _type: 'span',
+                                text: 'This is a demo portfolio, scaffolded by create-cogenta from the "portfolio" blueprint. Its projects and this page were seeded by the installer so there is real content to look at from the first run.',
+                                marks: [],
+                            },
+                        ],
+                        markDefs: [],
+                    },
+                ],
+            },
+            {
+                _key: 'demo-about-stats',
+                _type: 'stats',
+                _version: BLOCK_VERSION,
+                title: 'At a glance',
+                items: [
+                    { _key: 'demo-stat-1', value: '8', unit: 'years', label: 'in practice' },
+                    { _key: 'demo-stat-2', value: '40+', label: 'projects delivered' },
+                    { _key: 'demo-stat-3', value: '12', label: 'ongoing clients' },
+                ],
+            },
+        ],
+    },
+];
+export const PORTFOLIO_RECOMMENDED_AGENTS = [
+    {
+        name: 'performanceAgent',
+        package: '@cogenta/agents-builtin',
+        reason: 'Catches oversized project cover images before they slow the work grid down.',
+    },
+    {
+        name: 'seoAgent',
+        package: '@cogenta/agents-builtin',
+        reason: 'Audits project pages so each one is findable on its own, not only from the grid.',
+    },
+];
+/**
+ * Inserts the `portfolio` blueprint's demo content through the real
+ * `ContentStore` — never mocked (house rule).
+ */
+async function seedPortfolioDemoContent(db, defaultLocale, adminId) {
+    const projectStore = createContentStore({ db, collection: project, defaultLocale });
+    const pageStore = createContentStore({ db, collection: page, defaultLocale });
+    for (const demo of PORTFOLIO_DEMO_PROJECTS) {
+        await projectStore.create({
+            status: 'published',
+            createdBy: adminId,
+            values: {
+                title: demo.title,
+                slug: demo.slug,
+                summary: demo.summary,
+                role: demo.role,
+                year: demo.year,
+            },
+        });
+    }
+    for (const demo of PORTFOLIO_DEMO_PAGES) {
+        await pageStore.create({
+            status: 'published',
+            createdBy: adminId,
+            values: { title: demo.title, slug: demo.slug },
+            blocks: { blocks: demo.blocks.map(toBlockZoneEntry) },
+        });
+    }
+}
+export const portfolioContentPack = {
+    collections: PORTFOLIO_COLLECTIONS,
+    recommendedAgents: PORTFOLIO_RECOMMENDED_AGENTS,
+    seedDemoContent: seedPortfolioDemoContent,
+};
+//# sourceMappingURL=portfolio.js.map