@happyvertical/smrt-template-site-static-json 0.30.0

package/AGENTS.md

@@ -0,0 +1,30 @@
+# template-site-static-json
+
+Scaffold template for static community news sites with JSON data. Used by `smrt gnode create`.
+
+## Exports
+
+- Template config with placeholder mappings (site name, location, timezone, coordinates)
+- Template directory path and file path utilities
+
+## Template Contents
+
+- `template.config.js` — placeholder definitions and post-generation hooks
+- `template/scripts/init-data.ts` — data initialization script
+- `template/src/site.config.ts` — typed access to `smrt.config.js` site section (`initSiteConfig()`/`getSite()`)
+- `template/src/lib/components/WeatherHeader.svelte` — local weather-bar shim (was previously imported from `@happyvertical/smrt-svelte`, but that package dropped the component before the 0.24.x baseline). The shim renders the caelus-shaped `forecast` payload; consumers should customize for their data layer if they pull a different upstream.
+
+## Key Patterns
+
+- **Placeholder system**: variables (site name, location, timezone) replaced during `smrt gnode create`
+- **Post-generation hooks**: run after template files are copied (e.g., init-data.ts)
+- **Dependency injection**: `template/package.json` ships with empty `dependencies`/`devDependencies`; the scaffolder injects entries from `template.config.js` at generation time, so version bumps live in `template.config.js` only.
+- **Workflow scripts**: `workflow:caelus` and `workflow:praeco` are currently stubs that print a clear "upstream package needs a CLI bin" message and exit with status 1. Two independent reasons today's scaffold can't run them:
+  1. The upstream `@happyvertical/caelus` and `@happyvertical/praeco` packages are library-only — they do not declare a `bin` field, so `npx @happyvertical/caelus` / `npx @happyvertical/praeco` exits with "could not determine executable to run."
+  2. The template does not ship a local workflow shim (e.g. `template/src/workflows/caelus.ts`) that would import the upstream package and invoke the workflow from code. A `tsx`-based script would work fine if such a shim existed; the previous baseline pointed at `tsx src/workflows/caelus.ts` and failed only because the shim file was missing, not because tsx requires upstream to ship a bin.
+
+  Once upstream ships bins, replace the stubs with `npx @happyvertical/caelus --config smrt.config.js` / `npx @happyvertical/praeco --config smrt.config.js` (the scoped names — the unscoped `caelus` is a 404 on the public registry). Alternatively, add a `template/src/workflows/<name>.ts` shim that imports the upstream package's main export and invokes the workflow, then point the script at `tsx src/workflows/<name>.ts`. Until either is in place, callers who need these workflows should write the shim themselves in their generated project.
+
+## Runtime Dependencies
+
+Template projects use: `smrt-content`, `smrt-events`, `smrt-places`, `smrt-profiles`, `smrt-ui`.

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @happyvertical/smrt-template-site-static-json
+
+Template for static community news sites with JSON-based data storage. Generates a SvelteKit static site with weather integration (Caelus) and council meeting scraping (Praeco).
+
+## What This Template Provides
+
+- SvelteKit with `adapter-static` for static site generation
+- JSON file-based data storage in `data/`
+- Config-driven site identity, navigation, categories, and theming via `smrt.config.js`
+- Weather forecasts via Caelus (Environment Canada)
+- Council meeting scraping and article generation via Praeco
+- Typed site config helper (`initSiteConfig()`/`getSite()`)
+- Pre-built routes: home, about, contact
+- Markdown utility for content rendering
+
+## Prerequisites
+
+- Node.js 18+
+- pnpm (recommended)
+- Gemini API key (for Praeco article generation)
+
+## Usage
+
+```bash
+smrt gnode create my-town-site --template site-static-json \
+  --location "My Town, AB" \
+  --lat 53.5 --lon -113.5
+
+cd my-town-site
+pnpm install
+cp .env.example .env      # Add your GEMINI_API_KEY
+pnpm run init-data        # Initialize data directory
+pnpm dev                  # Start dev server
+```
+
+## Environment Variables
+
+Defined in `.env.example`:
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GEMINI_API_KEY` | Yes | Google Gemini API key for Praeco article generation |
+| `PUBLIC_GTM_ID` | No | Google Tag Manager container ID |
+| `CUSTOM_DOMAIN` | No | Custom domain for deployment |
+
+## Configuration
+
+Edit `smrt.config.js` to customize. Key sections:
+
+- **`site`** -- name, description, location, navigation links, theme colors
+- **`categories`** -- content categories for routing (e.g., `politics/local`)
+- **`modules.praeco`** -- council meeting sources and report configurations
+- **`modules.caelus`** -- weather location (set automatically from `--lat`/`--lon` flags)
+
+## Available Scripts
+
+| Script | Description |
+|--------|-------------|
+| `pnpm dev` | Start development server |
+| `pnpm build` | Build static site to `./build` |
+| `pnpm preview` | Preview the built site |
+| `pnpm run init-data` | Initialize JSON data files |
+| `pnpm run workflow:caelus` | Fetch weather data |
+| `pnpm run workflow:praeco` | Scrape council meetings |
+| `pnpm run validate:json` | Validate JSON data files |
+| `pnpm run validate:slugs` | Validate content slugs |
+
+## Template Structure
+
+```
+template/
+├── .env.example              # Environment variables
+├── .gitignore
+├── package.json              # Scripts and dependency placeholders
+├── smrt.config.js            # Site identity, modules, theme
+├── svelte.config.js          # SvelteKit with adapter-static
+├── tsconfig.json
+├── vite.config.ts
+├── data/                     # JSON data storage directory
+├── scripts/
+│   └── init-data.ts          # Data initialization script
+└── src/
+    ├── app.css               # Global styles
+    ├── app.d.ts              # SvelteKit type declarations
+    ├── app.html              # HTML shell
+    ├── site.config.ts        # Typed config helper (initSiteConfig/getSite)
+    ├── lib/
+    │   └── utils/
+    │       └── markdown.ts   # Markdown rendering utility
+    └── routes/
+        ├── +layout.server.ts # Loads site config for all routes
+        ├── +layout.svelte    # Root layout
+        ├── +page.server.ts   # Home page data
+        ├── +page.svelte      # Home page
+        ├── about/            # About page
+        └── contact/          # Contact page
+```
+
+## Placeholder Substitution
+
+During `smrt gnode create`, placeholders like `{{SITE_NAME}}`, `{{LOCATION_NAME}}`, `{{LATITUDE}}`, `{{LONGITUDE}}`, and `{{TIMEZONE}}` are replaced from CLI flags. See `template.config.js` for the full mapping.
+
+## Deployment
+
+This template uses SvelteKit's static adapter. Build and deploy to any static host:
+
+```bash
+pnpm build
+# Deploy ./build to S3, Netlify, Vercel, Cloudflare Pages, etc.
+```
+
+## Related
+
+- [SMRT Framework](https://github.com/happyvertical/smrt)
+- [SvelteKit](https://kit.svelte.dev/)

package/index.js

@@ -0,0 +1,8 @@
+/**
+ * Static Site Template
+ *
+ * Template for community news sites with JSON data storage.
+ * Use with: smrt gnode create <name> --template site-static-json
+ */
+
+export { default as config } from './template.config.js';

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@happyvertical/smrt-template-site-static-json",
+  "version": "0.30.0",
+  "description": "Static community site template with JSON data storage and SMRT framework",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./template/*": "./template/*"
+  },
+  "files": [
+    "CLAUDE.md",
+    "README.md",
+    "index.js",
+    "template",
+    "template.config.js",
+    "AGENTS.md"
+  ],
+  "keywords": [
+    "smrt",
+    "sveltekit",
+    "template",
+    "scaffold",
+    "community-site",
+    "static-site",
+    "json"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/template-site-static-json"
+  },
+  "peerDependencies": {
+    "@happyvertical/smrt-core": "0.30.0",
+    "@happyvertical/smrt-config": "0.30.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}

package/template/.env.example

@@ -0,0 +1,8 @@
+# AI Provider (for Praeco article generation)
+GEMINI_API_KEY=your-gemini-api-key
+
+# Optional: Google Tag Manager
+# PUBLIC_GTM_ID=GTM-XXXXXX
+
+# Optional: Custom domain for deployment
+# CUSTOM_DOMAIN=example.com

package/template/AGENTS.md

@@ -0,0 +1,21 @@
+# SMRT Static JSON Site
+
+This project uses SMRT configuration and generated local data for a static site.
+If SMRT objects are added, enable the SMRT Vite plugin so local knowledge
+artifacts are generated in `.smrt/smrt-knowledge.json`.
+
+## Agent Workflow
+
+- Treat `AGENTS.md` as the canonical project guidance file.
+- Keep `CLAUDE.md` as the one-line `@AGENTS.md` shim.
+- Use `smrt knowledge:architecture-context --format markdown` or the
+  `build-domain-architecture-context` MCP tool when adding SMRT packages.
+- Use `knowledge: { tags, summary, risks }` on domain objects that need
+  package-specific review guidance.
+
+## Safety
+
+- Do not expose `/__smrt/knowledge` HTTP routes in production without explicit
+  admin auth.
+- Keep generated data and `.smrt` artifacts out of source control unless the
+  project intentionally publishes a package artifact.

package/template/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/template/README.md

@@ -0,0 +1,59 @@
+# {{SITE_NAME}}
+
+Local news and community information for {{LOCATION_NAME}}.
+
+## Getting Started
+
+```bash
+# Install dependencies
+pnpm install
+
+# Initialize data files
+pnpm run init-data
+
+# Start development server
+pnpm dev
+```
+
+## Configuration
+
+Edit `smrt.config.js` to configure:
+
+- **Site identity**: Name, location, navigation
+- **Data sources**: Council meeting URLs for Praeco
+- **Weather**: Location coordinates for Caelus
+
+## Workflows
+
+```bash
+# Fetch weather data
+pnpm workflow:caelus
+
+# Generate articles from council meetings
+pnpm workflow:praeco
+```
+
+## Deployment
+
+```bash
+# Build static site
+pnpm build
+
+# Preview production build
+pnpm preview
+```
+
+Deploy the `build/` directory to any static host (S3, Netlify, Vercel, etc.).
+
+## Project Structure
+
+```
+├── smrt.config.js      # Site configuration
+├── data/               # JSON data storage
+├── scripts/            # Utility scripts
+└── src/
+    ├── site.config.ts  # Config helper
+    ├── app.css         # Global styles
+    ├── routes/         # SvelteKit pages
+    └── lib/            # Shared utilities
+```

package/template/data/.gitkeep

@@ -0,0 +1,2 @@
+# This file ensures the data directory exists in git.
+# JSON data files are generated and not committed.

package/template/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "{{PACKAGE_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "typecheck": "svelte-kit sync && tsc --noEmit && svelte-check --tsconfig ./tsconfig.json",
+    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+    "init-data": "tsx scripts/init-data.ts",
+    "workflow:caelus": "node -e \"console.error('workflow:caelus requires @happyvertical/caelus to ship a CLI bin (tracked upstream). For now invoke the workflow from a script that imports the package directly.'); process.exit(1)\"",
+    "workflow:praeco": "node -e \"console.error('workflow:praeco requires @happyvertical/praeco to ship a CLI bin (tracked upstream). For now invoke the workflow from a script that imports the package directly.'); process.exit(1)\"",
+    "validate:json": "tsx scripts/validate-json.ts",
+    "validate:slugs": "tsx scripts/validate-slugs.ts"
+  },
+  "devDependencies": {},
+  "dependencies": {}
+}

package/template/scripts/init-data.ts

@@ -0,0 +1,56 @@
+/**
+ * Initialize Data Directory
+ *
+ * Creates empty JSON files for the site's data storage.
+ * Run this after creating a new site: pnpm run init-data
+ */
+
+import { mkdir, writeFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+
+const DATA_DIR = join(process.cwd(), 'data');
+
+const INITIAL_FILES: Record<string, any[]> = {
+  'contents.json': [],
+  'events.json': [],
+  'places.json': [],
+  'profiles.json': [],
+  'assets.json': [],
+};
+
+async function initData() {
+  console.log('Initializing data directory...\n');
+
+  // Ensure data directory exists
+  try {
+    await access(DATA_DIR);
+    console.log('  ✓ data/ directory exists');
+  } catch {
+    await mkdir(DATA_DIR, { recursive: true });
+    console.log('  ✓ Created data/ directory');
+  }
+
+  // Create each data file if it doesn't exist
+  for (const [filename, initialData] of Object.entries(INITIAL_FILES)) {
+    const filepath = join(DATA_DIR, filename);
+    try {
+      await access(filepath);
+      console.log(`  • ${filename} exists, skipping`);
+    } catch {
+      await writeFile(filepath, JSON.stringify(initialData, null, 2));
+      console.log(`  ✓ Created ${filename}`);
+    }
+  }
+
+  console.log('\n✅ Data initialization complete!');
+  console.log('\nNext steps:');
+  console.log('  1. Configure smrt.config.js with your council sources');
+  console.log('  2. Run pnpm workflow:caelus to fetch weather data');
+  console.log('  3. Run pnpm workflow:praeco to generate articles');
+  console.log('  4. Run pnpm dev to start the development server');
+}
+
+initData().catch((error) => {
+  console.error('Failed to initialize data:', error);
+  process.exit(1);
+});

package/template/smrt.config.js

@@ -0,0 +1,138 @@
+/**
+ * SMRT Configuration for {{SITE_NAME}}
+ *
+ * This file configures site identity, navigation, data sources, and workflows.
+ */
+
+export default {
+  // Site identity (used by components for titles, navigation, SEO)
+  site: {
+    name: '{{SITE_NAME}}',
+    shortName: '{{SITE_SHORT_NAME}}',
+    description: 'Local news and community information for {{LOCATION_NAME}}',
+    url: 'https://{{PACKAGE_NAME}}.com',
+    location: {
+      name: '{{LOCATION_NAME}}',
+      latitude: {{LATITUDE}},
+      longitude: {{LONGITUDE}},
+      timezone: '{{TIMEZONE}}',
+    },
+    navigation: {
+      primary: [
+        { label: 'Politics', href: '/politics' },
+        { label: 'Weather', href: '/weather' },
+      ],
+      footer: [
+        { label: 'About', href: '/about' },
+        { label: 'Contact', href: '/contact' },
+        { label: 'RSS', href: '/rss.xml' },
+      ],
+    },
+    theme: {
+      primaryColor: '#1976d2',
+      primaryLight: '#e3f2fd',
+      primaryDark: '#0d47a1',
+    },
+  },
+
+  // Site-wide category definitions (for routing/navigation)
+  categories: {
+    politics: {
+      name: 'Politics',
+      children: {
+        local: { name: 'Local Government' },
+        county: { name: 'County Government' },
+      },
+    },
+    community: {
+      name: 'Community',
+      children: {
+        events: { name: 'Events' },
+      },
+    },
+  },
+
+  // Agent/developer knowledge defaults
+  knowledge: {
+    enabled: true,
+    api: {
+      enabled: false,
+      basePath: '/__smrt/knowledge',
+      requireAdmin: true,
+      includeDocs: false,
+      includePrompts: false,
+    },
+  },
+
+  // Global package settings
+  packages: {
+    cli: {
+      verbose: true,
+      database: {
+        type: 'json',
+        url: './data',
+      },
+    },
+    ai: {
+      defaultProvider: 'claude-cli',
+      defaultModel: 'sonnet',
+    },
+  },
+
+  // Module-specific configurations
+  modules: {
+    // Praeco module configuration (meeting scraper)
+    praeco: {
+      db: {
+        type: 'json',
+        url: './data',
+        writeStrategy: 'immediate',
+      },
+      ai: {
+        type: 'gemini',
+        model: 'gemini-2.0-flash-exp',
+        apiKey: process.env.GEMINI_API_KEY,
+      },
+      analyzeOptions: {
+        detailLevel: 'comprehensive',
+      },
+      // Add your council sources here
+      sources: [
+        // Example:
+        // {
+        //   type: 'documents',
+        //   council: 'my-council',
+        //   url: 'https://example.com/meetings/',
+        // },
+      ],
+      // Add your report configurations here
+      reports: [
+        // Example:
+        // {
+        //   type: 'meeting-recap',
+        //   council: 'my-council',
+        //   category: 'politics/local',
+        //   author: '{{SITE_SHORT_NAME}} Reporter',
+        //   role: 'You are a professional journalist writing for {{LOCATION_NAME}} residents.',
+        // },
+      ],
+    },
+
+    // Caelus module configuration (weather)
+    caelus: {
+      db: {
+        type: 'json',
+        url: './data',
+        writeStrategy: 'immediate',
+        clearCache: true,
+      },
+      provider: 'environment-canada',
+      location: {
+        name: '{{LOCATION_NAME}}',
+        latitude: {{LATITUDE}},
+        longitude: {{LONGITUDE}},
+      },
+      logLevel: 'info',
+    },
+  },
+};

package/template/src/app.css

@@ -0,0 +1,156 @@
+/**
+ * Global CSS for {{SITE_NAME}}
+ * Design tokens as CSS custom properties
+ */
+
+:root {
+  /* Colors - Primary (customize these in smrt.config.js site.theme) */
+  --color-primary: #1976d2;
+  --color-primary-main: #1976d2;
+  --color-primary-light: #e3f2fd;
+  --color-primary-dark: #0d47a1;
+
+  /* Colors - Neutral */
+  --color-neutral-white: #ffffff;
+  --color-neutral-gray100: #f5f5f5;
+  --color-neutral-gray200: #eeeeee;
+  --color-neutral-gray300: #e0e0e0;
+  --color-neutral-gray400: #bdbdbd;
+  --color-neutral-gray500: #9e9e9e;
+  --color-neutral-gray600: #757575;
+  --color-neutral-gray700: #616161;
+  --color-neutral-gray800: #424242;
+  --color-neutral-gray900: #212121;
+
+  /* Colors - Semantic */
+  --color-semantic-success: #4caf50;
+  --color-semantic-warning: #ff9800;
+  --color-semantic-error: #f44336;
+  --color-semantic-info: #2196f3;
+
+  /* Colors - Text */
+  --color-text-primary: #333333;
+  --color-text-secondary: #666666;
+  --color-text-disabled: #9e9e9e;
+  --color-text-inverse: #ffffff;
+
+  /* Spacing */
+  --spacing-xs: 0.25rem;
+  --spacing-sm: 0.5rem;
+  --spacing-md: 1rem;
+  --spacing-lg: 1.5rem;
+  --spacing-xl: 2rem;
+  --spacing-2xl: 3rem;
+  --spacing-3xl: 4rem;
+
+  /* Typography */
+  --font-family-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+  --font-family-serif: Georgia, 'Times New Roman', serif;
+  --font-family-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+
+  --font-size-xs: 0.75rem;
+  --font-size-sm: 0.875rem;
+  --font-size-base: 1rem;
+  --font-size-lg: 1.125rem;
+  --font-size-xl: 1.25rem;
+  --font-size-2xl: 1.5rem;
+  --font-size-3xl: 1.875rem;
+  --font-size-4xl: 2.25rem;
+
+  --font-weight-normal: 400;
+  --font-weight-medium: 500;
+  --font-weight-semibold: 600;
+  --font-weight-bold: 700;
+
+  --line-height-tight: 1.2;
+  --line-height-normal: 1.6;
+  --line-height-relaxed: 1.8;
+
+  /* Shadows */
+  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
+  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1);
+
+  /* Border Radius */
+  --radius-sm: 4px;
+  --radius-md: 8px;
+  --radius-lg: 12px;
+  --radius-full: 9999px;
+
+  /* Transitions */
+  --transition-fast: 150ms ease;
+  --transition-base: 200ms ease;
+  --transition-slow: 300ms ease;
+}
+
+/* Reset and base styles */
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: var(--font-family-sans);
+  font-size: var(--font-size-base);
+  line-height: var(--line-height-normal);
+  color: var(--color-text-primary);
+  background: var(--color-neutral-white);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+/* Typography defaults */
+h1, h2, h3, h4, h5, h6 {
+  margin: 0;
+  font-weight: var(--font-weight-semibold);
+  line-height: var(--line-height-tight);
+  color: var(--color-text-primary);
+}
+
+p {
+  margin: 0;
+}
+
+a {
+  color: var(--color-primary-main);
+  text-decoration: none;
+  transition: color var(--transition-fast);
+}
+
+a:hover {
+  color: var(--color-primary-dark);
+}
+
+/* Focus styles for accessibility */
+:focus-visible {
+  outline: 2px solid var(--color-primary-main);
+  outline-offset: 2px;
+}
+
+/* Remove default button styles */
+button {
+  font-family: inherit;
+  font-size: inherit;
+  line-height: inherit;
+  margin: 0;
+  padding: 0;
+  border: none;
+  background: none;
+  cursor: pointer;
+}
+
+/* Utility classes */
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border-width: 0;
+}