@se-studio/project-build 1.0.122 → 1.0.124

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @se-studio/project-build
 
+## 1.0.124
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
+## 1.0.123
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
 ## 1.0.122
 
 ### Patch Changes

package/dist/management/sync-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-skills.d.ts","sourceRoot":"","sources":["../../src/management/sync-skills.ts"],"names":[],"mappings":"AAmCA,wBAAsB,UAAU,CAC9B,SAAS,GAAE,MAAsB;AACjC,uGAAuG;AACvG,WAAW,UAAQ,iBAsCpB"}
+{"version":3,"file":"sync-skills.d.ts","sourceRoot":"","sources":["../../src/management/sync-skills.ts"],"names":[],"mappings":"AA+CA,wBAAsB,UAAU,CAC9B,SAAS,GAAE,MAAsB;AACjC,uGAAuG;AACvG,WAAW,UAAQ,iBAsEpB"}

package/dist/management/sync-skills.js

@@ -17,6 +17,16 @@ async function copyDir(src, dest) {
         }
     }
 }
+async function flattenGroup(srcGroupDir, prefix, targetDir) {
+    if (!fs.existsSync(srcGroupDir))
+        return;
+    const entries = await fs.promises.readdir(srcGroupDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        await copyDir(path.join(srcGroupDir, entry.name), path.join(targetDir, `${prefix}-${entry.name}`));
+    }
+}
 /**
  * Returns true when this script is running from inside a pnpm/npm workspace
  * (i.e. as a local package, not as an installed dependency from the registry).
@@ -56,7 +66,27 @@ ifInstalled = false) {
             console.error('This may be because the package was not built or installed correctly.');
             return;
         }
-        await copyDir(skillsSourceDir, skillsTargetDir);
+        // Remove stale nested group dirs and flat aliases before rebuilding
+        const groups = ['contentful-cms', 'se-marketing-sites', 'site-workflows'];
+        try {
+            const existing = await fs.promises.readdir(skillsTargetDir, { withFileTypes: true });
+            for (const entry of existing) {
+                if (!entry.isDirectory())
+                    continue;
+                const isNestedGroup = groups.includes(entry.name);
+                const isFlatAlias = groups.some((g) => entry.name.startsWith(`${g}-`));
+                if (isNestedGroup || isFlatAlias) {
+                    await fs.promises.rm(path.join(skillsTargetDir, entry.name), { recursive: true });
+                }
+            }
+        }
+        catch {
+            // target dir may not exist yet — fine
+        }
+        // Flatten group dirs into <group>-<skill>/ at the top level
+        await flattenGroup(path.join(skillsSourceDir, 'contentful-cms'), 'contentful-cms', skillsTargetDir);
+        await flattenGroup(path.join(skillsSourceDir, 'se-marketing-sites'), 'se-marketing-sites', skillsTargetDir);
+        await flattenGroup(path.join(skillsSourceDir, 'site-workflows'), 'site-workflows', skillsTargetDir);
         console.log('Skills synced successfully.');
     }
     catch (error) {

package/dist/management/sync-skills.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/project-build",
-  "version": "1.0.122",
+  "version": "1.0.124",
   "description": "Build tools and management scripts for SE Studio projects",
   "repository": {
     "type": "git",

package/skills/contentful-cms/alt-text-audit/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: "Alt Text Audit"
+description: "Audit and improve image alt text across site pages using cms-edit, with brand-aware terminology and accessibility best practices."
+---
+
+# Skill: contentful-cms — Alt Text Audit
+
+Use this skill when auditing or improving **image alt text** across a site's pages using `cms-edit`. Works with any brand context skill for customer-specific terminology.
+
+## Brand Context
+
+Before starting, check if a brand context skill is available (e.g., "OM1 Brand Context", "Something Else Brand Context"). If so, use its terminology, image interpretation guidelines, and brand voice when writing alt text.
+
+If no brand context is available, ask the user about any brand-specific terms before proceeding.
+
+## Workflow
+
+1. **Get all pages**: `cms-edit sitemap`
+2. **For each page** (or a specific page if the user specified one):
+   a. `cms-edit open /<slug>`
+   b. `cms-edit snapshot` — identify components with visual/image/media fields
+   c. For each image-bearing component:
+      - `cms-edit read @ref` to inspect fields
+      - Check `altText` on any image/visual references
+      - `cms-edit read @ref visual` to see asset details if needed
+   d. **Flag** images with:
+      - Missing alt text (empty or null)
+      - Generic alt text ("image", "photo", "banner", "screenshot", "img", "picture")
+      - Alt text that doesn't use brand terminology (if brand context available)
+      - Alt text over 125 characters
+   e. **Generate** improved alt text following the guidelines below
+   f. `cms-edit set @ref altText "new alt text"`
+   g. `cms-edit diff` to review, then `cms-edit save`
+
+## Alt Text Guidelines
+
+1. **Be specific and descriptive** — describe what is actually in the image
+2. **Use brand terminology** — refer to the brand context for correct terms
+3. **Keep under 125 characters** — screen readers truncate longer text
+4. **Don't start with** "Image of", "Photo of", "Picture of"
+5. **Decorative images** — set alt to "" (empty string) for dividers, background patterns
+6. **Context matters** — describe the image's purpose on the page, not just its visual content
+7. **Include relevant actions** — if people are doing something meaningful, describe it
+
+## Reading Page Content
+
+To understand a page before auditing its images, use `fetch_page_markdown` (from the site-workflows MCP server) with the page slug.
+
+## Output
+
+Present a summary table when complete:
+
+| Page | Component | Old Alt Text | New Alt Text | Status |
+|------|-----------|-------------|-------------|--------|
+
+Where Status is: Updated, Skipped (decorative), Already Good, or Needs Review.
+
+## Related skills
+
+See the **core** skill for the full cms-edit workflow (open, snapshot, read, set, save).

package/skills/contentful-cms/cms-guidelines/README.md

@@ -18,7 +18,7 @@ Guidelines are short markdown fragments — one per CMS type — that describe h
    pnpm --filter <appName> generate-showcase
    ```
    This writes `src/generated/showcase-examples.json`.
-3. **Curate showcase mocks** — run the [curate-showcase-mocks skill](.agents/skills/se-marketing-sites/curate-showcase-mocks/SKILL.md) to select the best examples into `showcase-mocks.json`. This makes the showcase (and screenshots) show realistic content.
+3. **Curate showcase mocks** — run the [curate-showcase-mocks skill](.agents/skills/se-marketing-sites-curate-showcase-mocks/SKILL.md) to select the best examples into `showcase-mocks.json`. This makes the showcase (and screenshots) show realistic content.
 4. **Generate field list** — parse TypeScript types to produce structured field metadata:
    ```bash
    # From the app directory:
@@ -27,7 +27,7 @@ Guidelines are short markdown fragments — one per CMS type — that describe h
    # Or from repo root:
    pnpm --filter <appName> exec cms-generate-field-list --app-dir .
    ```
-5. **Generate guidelines** — run the [Generate CMS guidelines skill](.agents/skills/contentful-cms/generate-cms-guidelines/SKILL.md).
+5. **Generate guidelines** — run the [Generate CMS guidelines skill](.agents/skills/contentful-cms-generate-cms-guidelines/SKILL.md).
 
 Steps 1–3 only need to be repeated when content or component code changes significantly. Step 4 only needs to be repeated when TypeScript types change. Step 5 can be re-run at any time.
 
@@ -35,7 +35,7 @@ Steps 1–3 only need to be repeated when content or component code changes sign
 
 ## How to run guideline generation
 
-Use the Cursor skill at [`.agents/skills/contentful-cms/generate-cms-guidelines/SKILL.md`](.agents/skills/contentful-cms/generate-cms-guidelines/SKILL.md). It supports three modes:
+Use the Cursor skill at [`.agents/skills/contentful-cms-generate-cms-guidelines/SKILL.md`](.agents/skills/contentful-cms-generate-cms-guidelines/SKILL.md). It supports three modes:
 
 | Mode | When to use |
 |---|---|

package/skills/contentful-cms/core/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: "contentful-cms:core"
+description: "Use cms-edit CLI to read/edit Contentful content (open → snapshot → read → set/rtf → diff → save)."
+---
+
 # Skill: contentful-cms CLI
 
 Use this skill when you need to read or edit content in Contentful CMS using the `cms-edit` CLI tool.

package/skills/contentful-cms/generate-cms-guidelines/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: "contentful-cms:generate-cms-guidelines"
+description: "Generate, regenerate, or merge CMS guideline markdown fragments for any app in the monorepo."
+---
+
 # Skill: Generate CMS Guidelines
 
 Use this skill when you need to generate, regenerate, or merge CMS guideline markdown fragments for any app in the monorepo.
@@ -27,7 +32,7 @@ Guidelines are only meaningful when the showcase is populated with realistic dat
    pnpm --filter <appName> generate-showcase
    ```
    This writes `src/generated/showcase-examples.json` to the app.
-3. **Curate showcase mocks:** Follow the [curate-showcase-mocks skill](.agents/skills/se-marketing-sites/curate-showcase-mocks/SKILL.md) to produce `showcase-mocks.json`.
+3. **Curate showcase mocks:** Follow the [curate-showcase-mocks skill](.agents/skills/se-marketing-sites-curate-showcase-mocks/SKILL.md) to produce `showcase-mocks.json`.
 4. **Generate field list:**
    ```bash
    # From the app directory:

package/skills/contentful-cms/manifest.json

@@ -3,5 +3,8 @@
   "templates": "Create and edit templates (preContent, postContent, menu, footer, colours)",
   "navigation": "Create navigation, nav open/add, set nav item fields, remove",
   "rich-text": "Rich text (rtf) and embeds (append/insert); Markdown support",
-  "screenshots": "Screenshot command, agent-browser requirement, mock vs live, --url-only"
+  "screenshots": "Screenshot command, agent-browser requirement, mock vs live, --url-only",
+  "alt-text-audit": "Audit and improve image alt text across site pages",
+  "seo-descriptions": "Generate or improve SEO meta descriptions for pages",
+  "schema-org": "Generate Schema.org structured data as Mustache templates"
 }

package/skills/contentful-cms/navigation/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: "contentful-cms:navigation"
+description: "Create or edit navigation entries and nav items in Contentful via cms-edit."
+---
+
 # Skill: contentful-cms — Navigation
 
 Use this skill when creating or editing **navigation** entries and their items in Contentful via `cms-edit`.

package/skills/contentful-cms/rich-text/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: "contentful-cms:rich-text"
+description: "Edit rich-text fields and insert embedded entries/assets via cms-edit."
+---
+
 # Skill: contentful-cms — Rich text and embeds
 
 Use this skill when editing **rich text** fields (body, additionalCopy) and inserting **embedded entries/assets** via `cms-edit`.

package/skills/contentful-cms/schema-org/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: "Schema.org Generation"
+description: "Generate Schema.org structured data as Mustache templates for site pages and upload via cms-edit."
+---
+
+# Skill: contentful-cms — Schema.org Generation
+
+Use this skill when generating **Schema.org structured data** (JSON-LD) as Mustache templates for pages and uploading via `cms-edit`. Works with any brand context skill for customer name and site URL.
+
+## Brand Context
+
+Before starting, check if a brand context skill is available. You'll need the customer name and site URL for Organisation and publisher fields in the schema templates.
+
+If no brand context is available, ask the user for these details.
+
+## Phase 1: Analyse Site Structure
+
+1. `cms-edit sitemap` to get all pages and articles
+2. For each page, use `fetch_page_markdown` (from site-workflows MCP server) to read content
+3. Categorise each page by Schema.org type:
+
+| Page Type | Likely Schema.org Type |
+|-----------|----------------------|
+| Homepage | Organization + WebSite |
+| About | AboutPage + Organization |
+| Service/Product | Service or Product |
+| Pricing | Product with Offer |
+| Blog listing | CollectionPage |
+| Article | Article or BlogPosting |
+| FAQ | FAQPage with Question/Answer |
+| Contact | ContactPage |
+| Team/People | ProfilePage or Person |
+| Case study | Article |
+| Landing page | WebPage |
+
+## Phase 2: Generate Mustache Templates
+
+Create JSON-LD templates using these standard Mustache variables:
+
+- `{{title}}` — page/article title
+- `{{seoDescription}}` — SEO meta description
+- `{{slug}}` — page slug
+- `{{publishDate}}` — article publish date
+- `{{updatedAt}}` — last modification date
+- `{{authorName}}` — article author name
+- `{{heroImageUrl}}` — primary image URL
+- `{{customerName}}` — from brand context
+- `{{siteUrl}}` — from brand context
+
+## Phase 3: Upload via cms-edit
+
+1. Check available fields:
+   - `cms-edit schema page` — page content type fields
+   - `cms-edit schema template` — template content type fields
+   - Look for `schemaOrg`, `jsonLd`, `structuredData`, or similar
+2. For **template-level** schemas (Organization, WebSite — shared): `cms-edit list --type template` → open → set
+3. For **page-level** schemas: open each page → set its schema field
+4. `cms-edit diff` then `cms-edit save`
+
+## Best Practices
+
+- Don't duplicate — template-level Organization schema covers all pages
+- Use specific types — `MedicalBusiness` over `LocalBusiness` if applicable
+- Validate all required properties are present
+- Schema must reflect actual page content
+
+## Output
+
+| Page/Template | Schema.org Type(s) | Variables Used | Applied To |
+|--------------|-------------------|---------------|-----------|
+
+## Related skills
+
+See the **core** skill for the full cms-edit workflow. See the **seo-descriptions** skill for meta description generation.

package/skills/contentful-cms/screenshots/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: "contentful-cms:screenshots"
+description: "Capture screenshots of components, collections, pages or persons via cms-edit."
+---
+
 # Skill: contentful-cms — Screenshots
 
 Use this skill when capturing **screenshots** of components, collections, pages, or persons with `cms-edit`. **Requires agent-browser** to be installed.

package/skills/contentful-cms/seo-descriptions/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: "SEO Descriptions"
+description: "Generate or improve SEO meta descriptions for pages using cms-edit, targeting keywords with the brand voice."
+---
+
+# Skill: contentful-cms — SEO Descriptions
+
+Use this skill when generating or improving **SEO meta descriptions** for pages using `cms-edit`. Works with any brand context skill for customer-specific voice and audience.
+
+## Brand Context
+
+Before starting, check if a brand context skill is available (e.g., "OM1 Brand Context"). If so, use its brand voice, target audience, SEO focus areas, and tone when writing descriptions.
+
+If no brand context is available, ask the user about their brand voice and target audience before proceeding.
+
+## Workflow
+
+1. **Get all pages**: `cms-edit sitemap`
+2. **For each page** (or a specific page):
+   a. **Read page content** using `fetch_page_markdown` (from the site-workflows MCP server) to understand what the page covers
+   b. **Check current SEO**:
+      - `cms-edit open /<slug>`
+      - `cms-edit read @page seoDescription` (or `read @page` for all fields)
+   c. **Analyse** the page — primary purpose, problem it solves, desired user action
+   d. **Generate** a meta description following the guidelines below
+   e. `cms-edit set @page seoDescription "new description"`
+   f. `cms-edit diff` then `cms-edit save`
+
+## Meta Description Guidelines
+
+1. **Length:** 150–160 characters (Google truncates at ~160)
+2. **Include the target keyword** naturally — don't stuff it
+3. **Use the brand voice** from the brand context
+4. **Include a call to action** — "Learn more", "Get started", "Discover", etc.
+5. **Be specific** — mention concrete benefits, not vague claims
+6. **Match search intent** — what would someone search to land on this page?
+7. **Avoid:**
+   - Starting with the brand name (it's in the title tag)
+   - "Welcome to..." or "This page is about..."
+   - Duplicating descriptions across pages
+   - Quotes (truncated in SERPs)
+
+## Output
+
+For each page, present:
+
+| Page | Current Description | New Description | Chars | Target Keyword |
+|------|-------------------|-----------------|-------|----------------|
+
+Then apply changes via cms-edit.
+
+## Related skills
+
+See the **core** skill for the full cms-edit workflow. See the **alt-text-audit** skill for image accessibility.

package/skills/contentful-cms/templates/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: "contentful-cms:templates"
+description: "Create or edit templates (preContent, postContent, menu, footer, colours) in Contentful via cms-edit."
+---
+
 # Skill: contentful-cms — Templates
 
 Use this skill when creating or editing **templates** (layout shells with preContent, postContent, menu, footer) in Contentful via `cms-edit`.

package/skills/contentful-cms/update-cms-guidelines/SKILL.md

@@ -112,7 +112,7 @@ grep -E "CONTENTFUL_SPACE_ID|CONTENTFUL_ACCESS_TOKEN|OPENAI_API_KEY|ANTHROPIC_AP
 ### Step 2 — Curate showcase mocks
 
 Read and follow the **curate-showcase-mocks** skill:
-`.agents/skills/se-marketing-sites/curate-showcase-mocks/SKILL.md`
+`.agents/skills/se-marketing-sites-curate-showcase-mocks/SKILL.md`
 
 This produces `src/generated/showcase-mocks.json` (committed) and
 `src/generated/cms-discovery/accepted-variants/{components|collections|externals}/<slug>.json` (often gitignored — **some apps commit them**; follow the app’s `.gitignore`).
@@ -150,7 +150,7 @@ Produces `generated/cms-discovery/field-list.json` (discovery API reads from thi
 ### Step 5 — Run generate-all-guidelines
 
 Read and follow the **generate-all-guidelines** skill:
-`.agents/skills/contentful-cms/generate-all-guidelines/SKILL.md`
+`.agents/skills/contentful-cms-generate-all-guidelines/SKILL.md`
 
 Skip its prerequisite check (you already verified everything through Step 4).
 Run Phases 0–5 from that skill with **full regeneration rules**:
@@ -342,7 +342,7 @@ All under `<appDir>`:
 
 | Purpose | Skill |
 |---|---|
-| Curate showcase mocks (Step 2 of `fresh`) | `.agents/skills/se-marketing-sites/curate-showcase-mocks/SKILL.md` |
-| Full-site bulk generation (Step 4 of `fresh`: Phases 0–5) | `.agents/skills/contentful-cms/generate-all-guidelines/SKILL.md` |
-| Single-type regeneration (after code change) | `.agents/skills/contentful-cms/generate-cms-guidelines/SKILL.md` (mode: single) |
+| Curate showcase mocks (Step 2 of `fresh`) | `.agents/skills/se-marketing-sites-curate-showcase-mocks/SKILL.md` |
+| Full-site bulk generation (Step 4 of `fresh`: Phases 0–5) | `.agents/skills/contentful-cms-generate-all-guidelines/SKILL.md` |
+| Single-type regeneration (after code change) | `.agents/skills/contentful-cms-generate-cms-guidelines/SKILL.md` (mode: single) |
 | Per-component pipeline detail | `packages/contentful-cms/skills/cms-guidelines/generate-component-guidelines.md` |