@inizioevoke/veeva-astroclm-core 1.0.3 → 1.0.4

package/agents/claude/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: inizioevoke-veeva-astroclm
+description: >
+  Skills and tools for working in this Veeva CLM Astro project (inizioevoke-veeva-astroclm).
+  Use this skill for any project-specific tasks such as creating pages, managing content, or
+  running project utilities. Triggers on any request that involves scaffolding, generating,
+  or managing project files in this Veeva CLM project.
+---
+
+# inizioevoke-veeva-astroclm Skills
+
+## Available skills
+
+- **Page Manager** — Create a new page in the project → read `page-manager/SKILL.md`
+- **Veeva Config Manager** — Manage Veeva CLM configuration → read `veeva-config-manager/SKILL.md`

package/agents/claude/page-manager/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: inizioevoke-veeva-astroclm-pagemanager
+description: >
+  Scaffolds a new page in this Veeva CLM Astro project. Use this skill whenever the user asks to
+  create a new page, add a page, scaffold a slide, generate a new route, or set up a new CLM slide —
+  even if they don't say "page manager" explicitly. If the user is working in this project and wants
+  a new page, this skill should always trigger.
+---
+
+# Page Manager
+
+## Step 1 — Ask for the page path
+
+Ask: "What should the page path be? (relative to `src/contents/`, e.g. `home` or `module-1/slide-2`)"
+
+## Step 2 — Ask for the layout
+
+Read `src/layouts/` to discover available layouts (each subdirectory containing a `.astro` file is a layout). Present them as a numbered list, for example:
+
+```
+Which layout would you like to use?
+  1. GlobalLayout
+  2. LeftNavLayout
+  3. TopNavLayout
+```
+
+The user can respond with just a number. Resolve it to the layout name (e.g. `TopNavLayout`) before proceeding.
+
+## Step 3 — Check for veeva-config.ts
+
+Check if `veeva-config.ts` exists in the project root. If it does, ask the user: "Would you like to add a slide entry for this page in `veeva-config.ts`?"
+
+## Step 4 — Create files
+
+Given the page path (e.g. `this/one`):
+- `contentName` = last segment of the path (e.g. `one`)
+- `pageName` = full path with `/` replaced by `-` (e.g. `this-one`)
+
+Check that neither `src/pages/<pageName>.astro` nor `src/contents/<path>/` already exist — if either does, stop and tell the user.
+
+**Write `src/pages/<pageName>.astro`:**
+```astro
+---
+import Page from '@/contents/<path>/<contentName>.astro';
+---
+<Page />
+```
+
+**Create `src/contents/<path>/` and write `<contentName>.astro`:**
+```astro
+---
+import <layoutName> from '@/layouts/<layoutName>/<layoutName>.astro';
+
+import './<contentName>.scss';
+---
+<<layoutName>>
+  <!-- Insert page content here -->
+  
+  <script>
+    import './<contentName>';
+  </script>
+</<layoutName>>
+```
+
+**Write `src/contents/<path>/<contentName>.scss`:** empty file
+
+**Write `src/contents/<path>/<contentName>.ts`:** empty file
+
+## Step 5 — Add slide to veeva-config.ts
+
+If the user said yes in Step 3, add a new slide entry to `presentation.slides` following the pattern in `../veeva-config-manager/manage.md` (Step 3 — Resolve missing slides).
+
+## Step 6 — Report
+
+Tell the user which files were created.

package/agents/claude/veeva-config-manager/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: inizioevoke-veeva-astroclm-veeva-config-manager
+description: >
+  Manages Veeva CLM configuration for this project. Use this skill whenever the user asks to
+  create, generate, or set up a Veeva config, initialize a veeva-config.ts, scaffold a new
+  presentation, or run the veeva-config-manager. Also trigger when the user says things like
+  "set up the config", "create the config file", "initialize the presentation config",
+  "sync the config", "check the config", or "update the slides in the config".
+---
+
+# Veeva Config Manager
+
+## Available skills
+
+- **Create config** — Generate a `veeva-config.ts` file for the project → read `create.md`
+- **Manage config** — Sync `veeva-config.ts` slides with `src/pages/` → read `manage.md`

package/agents/claude/veeva-config-manager/create.md

@@ -0,0 +1,154 @@
+# veeva-create-config
+
+Interactively collect presentation metadata from the user and write a
+`veeva-config.ts` file to the project root, replicating the flow in
+`src/apps/veeva-config-manager/create.ts`.
+
+## What you need from the user
+
+Gather **all** of the following before writing any files. Ask for them
+conversationally, batching related questions into a single message to minimize
+round-trips:
+
+| Field | Options / constraints |
+|---|---|
+| **Product name** | Free text, required |
+| **Presentation name** | Free text, required |
+| **Presentation ID** | Free text; default = presentation name lowercased, non-alphanumeric → `_` |
+| **IVA dimensions** | `1024 × 768`, `1366 × 1024` *(default)*, `1376 × 1032` |
+| **iOS resolution** | `Default For Device` *(default)*, `Scale To Fit`, `Scale To 1024x768` |
+| **Disabled actions** | Multi-select, none required: History Buttons, Navigation Bar, Pinch to Exit, Reactions, Rotation Lock, Swipe, Zoom |
+| **CRM target** | `Salesforce` *(default)*, `Vault` |
+
+## Generating IDs
+
+You will need two kinds of random IDs. Implement them inline with JavaScript/TypeScript logic or generate them yourself:
+
+- **External ID prefix**: First 3 chars of `product` (uppercased) + `_` + an 8-char alphanumeric random string (uppercase A–Z, 0–9).
+  Example: product `Velorixin` → `VEL_3K9BW12X`
+- **Per-slide ID**: An independent 8-char alphanumeric random string for each slide, unique within the set.
+
+To generate an 8-char random-ish ID in a bash snippet you can run:
+```bash
+node -e "const a='0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';let r='';for(let i=0;i<8;i++)r+=a[Math.floor(Math.random()*36)];console.log(r)"
+```
+Or generate them yourself — just make them look like `3K9BW12X` (8 uppercase alphanumeric chars).
+
+## Discovering slides
+
+Read all `.astro` files in `src/pages/`:
+
+```bash
+ls src/pages/*.astro 2>/dev/null
+```
+
+For each file `some-page-name.astro`:
+- `path` = filename without `.astro` extension (e.g. `some-page-name`)
+- `title` = title-case the path by splitting on `-`, capitalising each part, joining with space (e.g. `Some Page Name`)
+- `externalId` = `formatExtId('<SLIDE_ID>')` — keep as a function call literal in the output. Ensure that `<SLIDE_ID>` is unique
+
+## Output format
+
+Write `veeva-config.ts` to the **project root** using exactly this template
+(replace all `##...##` tokens with the collected/generated values):
+
+```ts
+import type { IVeevaClmBinderFields, IVeevaConfig, VeevaEnv } from "@inizioevoke/veeva-astroclm-core/types";
+import { formatExtId as __formatExtId } from '@inizioevoke/veeva-astroclm-core/lib';
+
+interface IVeevaConfigArgs {
+  veevaEnv?: VeevaEnv;
+  isTraining?: boolean;
+}
+export default function ({ veevaEnv = 'client', isTraining = false }: IVeevaConfigArgs = {}): IVeevaConfig {
+  const isEvokeBuild = veevaEnv === 'evoke';
+  const EXT_ID = `##EXTERNAL_ID##${isTraining ? '_TRN' : ''}`;
+  const PRESENTATION_NAME = '##PRESENTATION_NAME##';
+
+  const formatExtId = (id: string) => {
+    return __formatExtId(EXT_ID, id);
+  };
+
+  const binderFields: IVeevaClmBinderFields = {
+    // language: isEvokeBuild ? undefined : 'English',
+    // crmOrg: isEvokeBuild ? undefined : { crmId: ['CRM_ORD_ID'] },
+    // crmProduct: isEvokeBuild ? undefined : { id: 'VEEVA_ID_FROM_URL' },
+    // crmDetailGroup: isEvokeBuild ? undefined : { id: 'VEEVA_ID_FROM_URL' },
+    // detailGroup: undefined
+  };
+
+  return {
+    dimensions: { width: ##DIMENSIONS_WIDTH##, height: ##DIMENSIONS_HEIGHT## },
+    thumbnails: {
+      default: {
+        queryStringParams: {
+          screenshots: true
+        }
+      }
+    },
+    presentation: {
+      externalId: EXT_ID,
+      presentationId: `##PRESENTATION_ID##${isTraining ? '_trn' : ''}`,
+      product: '##PRODUCT##',
+      name: `${PRESENTATION_NAME}${isTraining ? ' [Training]' : ''}`,
+      country: 'United States',
+      isTraining,
+      crmTarget: '##CRM_TARGET##',
+      ...binderFields,
+
+      shared: {
+        externalId: formatExtId('SHARED'),
+        ...binderFields
+      },
+
+      slideSettings: {
+        mediaType: 'HTML',
+        disableActions: ##DISABLE_ACTIONS##,
+        iosResolution: '##IOS_RESOLUTION##',
+        ...binderFields
+      },
+      slides: ##SLIDES##
+    }
+  };
+}
+
+```
+
+### Token substitution reference
+
+| Token | Value |
+|---|---|
+| `##EXTERNAL_ID##` | e.g. `OZE_3K9BW12X` |
+| `##PRESENTATION_NAME##` | cleaned presentation name (trim, collapse double spaces) |
+| `##PRESENTATION_ID##` | cleaned presentation ID |
+| `##PRODUCT##` | cleaned product name |
+| `##DIMENSIONS_WIDTH##` | numeric width, no quotes (e.g. `1366`) |
+| `##DIMENSIONS_HEIGHT##` | numeric height, no quotes (e.g. `1024`) |
+| `##IOS_RESOLUTION##` | string value as-is (e.g. `Default For Device`) |
+| `##DISABLE_ACTIONS##` | TS array literal e.g. `['Swipe', 'Zoom']` or `[]` |
+| `##CRM_TARGET##` | `Salesforce` or `Vault` |
+| `##SLIDES##` | Array of slide objects (see below) |
+
+### Slides array format
+
+```ts
+[{
+  path: 'some-page-name',
+  title: 'Some Page Name',
+  externalId: formatExtId('3K9BW12X')
+}, {
+  path: 'another-page',
+  title: 'Another Page',
+  externalId: formatExtId('7XZ2M4QR')
+}]
+```
+
+## "Clean input" rule
+
+Before using any free-text value in the output: `.trim()` and replace runs of
+two or more spaces with a single space. Do not otherwise transform user input.
+
+## After writing the file
+
+Tell the user where the file was written (`veeva-config.ts` in the project
+root) and list the slides that were detected.

package/agents/claude/veeva-config-manager/manage.md

@@ -0,0 +1,48 @@
+# veeva-manage-config
+
+Audit `veeva-config.ts` against `src/pages/` to keep slides in sync with the actual pages in the project.
+
+## Step 1 — Discover pages and slides
+
+Run in parallel:
+
+1. List all `.astro` files in `src/pages/`:
+   ```bash
+   ls src/pages/*.astro 2>/dev/null
+   ```
+   Extract the `path` for each: filename without the `.astro` extension (e.g. `some-page-name`).
+
+2. Read `veeva-config.ts` from the project root and extract the `path` property from each entry in `presentation.slides`.
+
+## Step 2 — Compare
+
+Identify:
+- **Missing slides** — pages in `src/pages/` that have no matching entry in `slides`
+- **Extraneous slides** — entries in `slides` whose `path` has no matching file in `src/pages/`
+
+If everything is in sync, tell the user and stop.
+
+## Step 3 — Resolve missing slides
+
+For each missing slide, ask the user: "No slide entry found for `<path>`. Add it to `veeva-config.ts`?"
+
+If yes, add a new slide object to the `slides` array following the same pattern from `create.md`:
+- `path` = the page filename without `.astro`
+- `title` = title-case by splitting on `-`, capitalising each part, joining with a space
+- `externalId` = `formatExtId('<SLIDE_ID>')` where `<SLIDE_ID>` is a new unique 8-char uppercase alphanumeric string, different from all existing slide IDs in the file
+
+Generate the ID with:
+```bash
+node -e "const a='0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ';let r='';for(let i=0;i<8;i++)r+=a[Math.floor(Math.random()*36)];console.log(r)"
+```
+
+## Step 4 — Resolve extraneous slides
+
+For each extraneous slide, ask the user: "Slide entry `<path>` has no matching page. Remove it or comment it out?"
+
+- **Remove** — delete the slide object from the array entirely
+- **Comment out** — wrap the slide object in a block comment: `/* { path: '...', ... } */`
+
+## Step 5 — Write the file
+
+If any changes were made, write the updated `veeva-config.ts` and tell the user what was added, removed, or commented out.

package/package.json

@@ -1,20 +1,27 @@
 {
   "name": "@inizioevoke/veeva-astroclm-core",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "",
   "license": "ISC",
   "author": "",
   "type": "module",
   "scripts": {
     "prepublishOnly": "npm run build",
-    "build": "npx tsx build.ts --cmd pre && tsc && npx tsx build.ts --cmd post"
+    "build": "npx tsx build.ts --cmd pre && tsc && npx tsx build.ts --cmd post",
+    "postinstall": "node postinstall.mjs"
   },
   "exports": {
     "./apps": "./dist/apps/index.js",
     "./env": "./dist/env/index.js",
     "./integrations": "./dist/integrations/index.js",
-    "./lib": "./dist/lib/index.js",
-    "./lib/server": "./dist/lib/server.js",
+    "./lib": {
+      "types": "./dist/lib/index.d.ts",
+      "default": "./dist/lib/index.js"
+    },
+    "./lib/server": {
+      "types": "./dist/lib/server.d.ts",
+      "default": "./dist/lib/server.js"
+    },
     "./tasks": "./dist/tasks/index.js",
     "./types": "./dist/types/index.d.ts"
   },

package/postinstall.mjs

@@ -0,0 +1,17 @@
+import { copyFileSync, mkdirSync, rmSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Resolve the consuming project's root (three levels up from node_modules/@inizioevoke/astro-core)
+const projectRoot = join(__dirname, '..', '..', '..');
+const destDir = join(projectRoot, '.claude', 'skills', 'inizioevoke-veeva-astroclm-core');
+const src = join(__dirname, 'agents', 'claude', 'SKILL.md');
+const dest = join(destDir, 'SKILL.md');
+
+rmSync(destDir, { recursive: true, force: true });
+mkdirSync(destDir, { recursive: true });
+
+copyFileSync(src, dest);
+console.log(`[@inizioevoke/veeva-astroclm-core] Copied skill to ${dest}`);