@ignite-agent/agent 0.5.1 → 0.6.0

package/dist/wiki-content/schema.js

@@ -0,0 +1,173 @@
+import { z } from 'zod';
+export const ENTITY_TYPES = ['company', 'product', 'person', 'concept', 'location', 'offering'];
+const slug = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, 'slug must be kebab-case: a-z, 0-9 and single dashes');
+const isoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'date must be YYYY-MM-DD');
+const httpUrl = z.string().regex(/^https?:\/\/\S+$/, 'url must be absolute http(s)');
+const text = z.string().trim().min(1);
+const definition = z
+    .object({
+    lede: z.string().trim().optional(),
+    category: z.string().trim().optional(),
+    founded: z.string().trim().optional(),
+    function: z.string().trim().optional(),
+    differentiator: z.string().trim().optional(),
+})
+    .superRefine((value, ctx) => {
+    const hasLede = (value.lede ?? '') !== '';
+    const hasFields = (value.category ?? '') !== '' && (value.function ?? '') !== '';
+    if (!hasLede && !hasFields) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'definition needs a non-empty lede, or both category and function',
+        });
+    }
+});
+export const wikiEntitySchema = z.object({
+    entity_type: z.enum(ENTITY_TYPES),
+    canonical_name: text,
+    slug,
+    aliases: z.array(text).default([]),
+    definition,
+    sections: z
+        .array(z.object({
+        heading: text,
+        paragraphs: z.array(text).default([]),
+        stats: z
+            .array(z.object({
+            text,
+            citation: z.number().int().min(1),
+        }))
+            .default([]),
+    }))
+        .default([]),
+    cross_links: z.array(z.object({ target_slug: slug, anchor: z.string().optional() })).default([]),
+    citations: z
+        .array(z.object({
+        n: z.number().int().min(1),
+        url: httpUrl,
+        title: text,
+        accessed: isoDate,
+    }))
+        .default([]),
+    author: z.object({ name: text, url: httpUrl.optional() }).optional(),
+    changelog: z.array(z.object({ date: isoDate, note: text })).default([]),
+    same_as: z.array(httpUrl).default([]),
+    // Present on files `ignite wiki pull` wrote. A file without it was authored by a person and is never overwritten.
+    imported_from: z
+        .object({
+        source: z.literal('ignite'),
+        slug: z.string(),
+        dateModified: z.string(),
+    })
+        .optional(),
+});
+// Parses one file's JSON against the schema. Returns issues instead of throwing so a validator can list every file.
+export function parseWikiEntity(file, raw) {
+    const result = wikiEntitySchema.safeParse(raw);
+    if (!result.success) {
+        return {
+            entity: null,
+            issues: result.error.issues.map((issue) => ({
+                file,
+                message: `${issue.path.length > 0 ? `${issue.path.join('.')}: ` : ''}${issue.message}`,
+            })),
+        };
+    }
+    return { entity: result.data, issues: [] };
+}
+// The cross-file invariants: everything a single-file schema cannot see.
+export function validateWikiSet(entries) {
+    const issues = [];
+    const bySlug = new Map();
+    for (const { file, entity } of entries) {
+        const expected = fileSlug(file);
+        if (expected !== null && expected !== entity.slug) {
+            issues.push({ file, message: `slug "${entity.slug}" does not match the file name "${expected}"` });
+        }
+        const seenIn = bySlug.get(entity.slug);
+        if (seenIn) {
+            issues.push({ file, message: `duplicate slug "${entity.slug}" (also in ${seenIn})` });
+        }
+        else {
+            bySlug.set(entity.slug, file);
+        }
+        const citationIndices = new Set();
+        for (const citation of entity.citations) {
+            if (citationIndices.has(citation.n)) {
+                issues.push({ file, message: `duplicate citation index [${citation.n}]` });
+            }
+            citationIndices.add(citation.n);
+        }
+        entity.sections.forEach((section, s) => {
+            section.stats.forEach((stat, i) => {
+                if (!citationIndices.has(stat.citation)) {
+                    issues.push({
+                        file,
+                        message: `sections[${s}].stats[${i}] cites [${stat.citation}] but no citation has n=${stat.citation}`,
+                    });
+                }
+            });
+        });
+    }
+    for (const { file, entity } of entries) {
+        for (const link of entity.cross_links) {
+            if (!bySlug.has(link.target_slug)) {
+                issues.push({ file, message: `cross_links target "${link.target_slug}" resolves to no entity file` });
+            }
+        }
+    }
+    return issues;
+}
+export function fileSlug(file) {
+    const base = file.split(/[\\/]/).pop() ?? '';
+    if (!base.endsWith('.json'))
+        return null;
+    const stem = base.slice(0, -'.json'.length);
+    return stem.startsWith('_') ? null : stem;
+}
+export function entityTypeLabel(type) {
+    const labels = {
+        company: 'Company',
+        product: 'Product',
+        person: 'Person',
+        concept: 'Concept',
+        location: 'Location',
+        offering: 'Service',
+    };
+    return labels[type];
+}
+export function schemaOrgType(type) {
+    const map = {
+        company: 'Organization',
+        product: 'Product',
+        person: 'Person',
+        concept: 'Thing',
+        location: 'Place',
+        offering: 'Service',
+    };
+    return map[type];
+}
+// The canonical definition block as one lede paragraph: the stored lede when there is one, otherwise the
+// fields joined in the order the template prescribes. Nothing is invented for a missing field.
+export function definitionLede(entity) {
+    const d = entity.definition;
+    if (d.lede && d.lede.trim() !== '')
+        return d.lede.trim();
+    const category = d.category?.trim() || entityTypeLabel(entity.entity_type).toLowerCase();
+    const parts = [`${entity.canonical_name} is a ${category}`];
+    if (d.founded?.trim())
+        parts.push(`founded in ${d.founded.trim()}`);
+    if (d.function?.trim())
+        parts.push(`that ${stripTrailingPeriod(d.function.trim())}`);
+    let lede = `${parts.join(' ')}.`;
+    if (d.differentiator?.trim())
+        lede += ` ${ensurePeriod(d.differentiator.trim())}`;
+    return lede;
+}
+function stripTrailingPeriod(value) {
+    return value.replace(/\.+$/, '');
+}
+function ensurePeriod(value) {
+    return /[.!?]$/.test(value) ? value : `${value}.`;
+}
+//# sourceMappingURL=schema.js.map

package/dist/wiki-content/schema.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ignite-agent/agent",
-  "version": "0.5.1",
-  "description": "Ignite for Next.js: App Router SDK for robots, sitemap, JSON-LD, metadata, crawl logging, hosted wiki/blog pages, and a content-inventory seed. Server-only. The front end reads JSON; MCP is for coding agents, not the browser.",
+  "version": "0.6.0",
+  "description": "Ignite for Next.js: App Router SDK for robots, sitemap, JSON-LD, metadata, crawl logging, hosted wiki/blog pages, a content-inventory seed, and a validated Brand Wiki from repo JSON. Server-only. The front end reads JSON; MCP is for coding agents, not the browser.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
   "private": false,
@@ -17,6 +17,7 @@
   "files": [
     "dist",
     "onboarding",
+    "skills",
     "LICENSE",
     "AI.txt",
     "dist/ignite.css",
@@ -34,16 +35,18 @@
     "./wiki": "./dist/operator/wiki.js",
     "./blog": "./dist/operator/blog.js",
     "./client": "./dist/client-public.js",
+    "./wiki-content": "./dist/wiki-content/index.js",
     "./styles.css": "./dist/ignite.css"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json && node scripts/write-css.mjs",
     "prepublishOnly": "npm run build",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build && node --test dist/client.test.js dist/mcp.test.js dist/operator/ui.test.js dist/operator/sitemap-merge.test.js dist/cli/project.test.js dist/cli/seed.test.js"
+    "test": "npm run build && node --test dist/client.test.js dist/mcp.test.js dist/operator/ui.test.js dist/operator/sitemap-merge.test.js dist/cli/project.test.js dist/cli/seed.test.js dist/wiki-content/wiki.test.js"
   },
   "dependencies": {
-    "server-only": "^0.0.1"
+    "server-only": "^0.0.1",
+    "zod": "^4.5.4"
   },
   "peerDependencies": {
     "next": ">=15.0.0 <17.0.0",
@@ -57,6 +60,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.2.7",
     "next": "^16.3.0",
     "react": "^19.0.0",
     "typescript": "^5.6.0"

package/skills/ignite-brand-wiki/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: ignite-brand-wiki
+description: Build and maintain the Brand Wiki in a Next.js App Router site with @ignite-agent/agent — entity files in content/wiki, six fixed page regions, a build-time honesty gate, factual JSON-LD. Use when asked to add, generate, pull, validate or edit the wiki, or when touching content/wiki/*.json or app/wiki/*.
+---
+
+# Brand Wiki on Next.js
+
+One entity per page. Content lives in the repo as validated JSON under `content/wiki/`. Git is the CMS: a
+page changes through a reviewable diff, never through an admin UI. Pages render statically; nothing in the
+content path runs in the browser.
+
+The structure is evidence-based. It is not a ranking lever, and JSON-LD here is factual structure only.
+Never describe it to the user as a way to get cited or ranked.
+
+## Before you start
+
+- App Router project (`app/` or `src/app/`), `@ignite-agent/agent` >= 0.6 installed.
+- `IGNITE_SITE_ID`, `IGNITE_SITE_TOKEN` and `IGNITE_SITE_URL` set in `.env.local` and in the host. Run
+  `npx ignite doctor` if unsure. The token stays on the server. Never `NEXT_PUBLIC_`.
+- Optional: `IGNITE_SITE_NAME` (title suffix), `IGNITE_WIKI_BASE_PATH` (default `/wiki`), `IGNITE_LOCALE`
+  (must match `<html lang>`).
+
+## 1. Pull the pages Ignite already wrote
+
+```bash
+npx ignite wiki pull --dry-run   # lists what would be written
+npx ignite wiki pull
+```
+
+Each published wiki page in the user's Ignite workspace becomes `content/wiki/<slug>.json`. The import
+carries only what the page states: the lede, the sections, the paragraphs that cite a source, the source
+list, the author, the dates. It starts every file as `entity_type: "concept"` with no aliases, and it
+records `imported_from`. A file without `imported_from` was written by a person and is never overwritten.
+
+## 2. Review every imported file with the user
+
+For each file, settle with the user (do not guess):
+
+- `entity_type`: `company | product | person | concept | location | offering`.
+- `canonical_name` and `aliases`. Every anchor on the site uses the canonical form; an alias is never an anchor.
+- `definition`: either a `lede` paragraph, or `category` + `function` (+ optional `founded`,
+  `differentiator`). The lede is the first crawlable paragraph. Leave a field out rather than invent it.
+- `cross_links`: `target_slug` of related entities. The anchor text rendered is the target's canonical name.
+- `same_as`: only real, public profile URLs the user confirms.
+
+A stat without a real source is deleted, not sourced from memory. A citation needs `n`, an http(s) `url`, a
+`title` and an `accessed` date (`YYYY-MM-DD`). Dates and founders are facts the user supplies, never
+inferred.
+
+## 3. Write new entities
+
+Same shape, by hand or with the user. Minimum viable file:
+
+```json
+{
+  "entity_type": "company",
+  "canonical_name": "Northwind",
+  "slug": "northwind",
+  "aliases": ["Northwind Traders"],
+  "definition": { "category": "logistics software", "founded": "2019", "function": "routes regional freight for small carriers", "differentiator": "Runs on the carrier's own data; nothing is pooled across customers." },
+  "sections": [
+    { "heading": "What does Northwind do?", "paragraphs": ["…"], "stats": [{ "text": "Carriers on Northwind cut empty miles by 12% in 2025 [1].", "citation": 1 }] }
+  ],
+  "cross_links": [{ "target_slug": "route-planning" }],
+  "citations": [{ "n": 1, "url": "https://northwind.example/reports/2025", "title": "Northwind 2025 operations report", "accessed": "2026-09-01" }],
+  "author": { "name": "Northwind editorial", "url": "https://northwind.example/about" },
+  "changelog": [{ "date": "2026-09-01", "note": "First published." }],
+  "same_as": ["https://www.linkedin.com/company/northwind"]
+}
+```
+
+Section headings are question-shaped. `[n]` markers in text link to `#cite-n`.
+
+## 4. Wire the routes (greenfield only; never overwrite a host file)
+
+```ts
+// app/wiki/[slug]/page.tsx
+export { default, generateStaticParams, generateMetadata, dynamicParams, revalidate } from '@ignite-agent/agent/wiki-content'
+```
+
+```ts
+// app/wiki/page.tsx
+export { WikiContentIndex as default, revalidate } from '@ignite-agent/agent/wiki-content'
+```
+
+```tsx
+// app/wiki/layout.tsx  (optional sidebar)
+import { WikiContentLayout } from '@ignite-agent/agent/wiki-content'
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return <WikiContentLayout>{children}</WikiContentLayout>
+}
+```
+
+Sitemap: merge `wikiSitemapEntries()` from `@ignite-agent/agent/wiki-content` into the existing
+`app/sitemap.ts` (with `mergeSitemap` from `@ignite-agent/agent/sitemap` when the host already has one).
+`lastModified` is the entity's last-reviewed date, the same value the footer and JSON-LD show.
+
+If `app/w/` already serves Ignite wiki pages at runtime, keep it or remove it with the user; do not run both
+for the same slugs.
+
+## 5. Gate the build
+
+```json
+{ "scripts": { "prebuild": "ignite wiki validate" } }
+```
+
+`ignite wiki validate` fails (exit 1, one `BUILD ERROR` line per problem) on: a stat citing an index no
+citation has, a citation URL that is not http(s), a `cross_links` target with no file, duplicate slugs or
+citation indices, a slug that does not match its file name, an empty definition. The page loader applies the
+same schema and throws on drift, so `next build` cannot ship a page the gate refused.
+
+## 6. Prove it in the static HTML
+
+After `next build`, for one entity:
+
+```bash
+curl -s https://<site>/wiki/<slug> | grep -c 'id="definition"'   # 1
+curl -s https://<site>/wiki/<slug> | grep -c 'id="cite-1"'       # 1 when the page has a citation
+```
+
+The definition and citations must be in the raw response, not hydrated in. One `<h1>`, no heading skips, one
+`application/ld+json` script per page.
+
+## Rules
+
+- Server-only. No `"use client"` in the content path. No client fetching.
+- Never invent a stat, a citation, a date, a founder or a `sameAs` URL. Missing means omitted.
+- Never emit ratings, reviews, FAQPage or speakable JSON-LD; there is no data for them.
+- Do not add a CMS, search, comments or revision UI. The PR diff is the accountability surface.
+- Do not present any of this as a ranking lever.