dineway 0.1.6 → 0.1.8

package/README.md

@@ -1,60 +1,199 @@
 # dineway
 
-The core Dineway package — the Agentic Website builder for restaurants and local businesses. Combines structured content modeling with the Model Context Protocol (MCP) to create intelligent, AI-powered sites.
+The Agentic Website builder for restaurants and local businesses. Dineway combines structured content modeling with the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) to create intelligent, AI-powered sites that understand your menu, manage your reputation, and act on your behalf.
+
+## Overview
+
+Dineway is an [Astro](https://astro.build) integration that gives your site a full content engine, admin panel, built-in MCP server, and plugin system. It runs on Node.js with SQLite/libSQL (or PostgreSQL), deploys anywhere with a single command, and stores all schema in the database — not in code.
+
+### Architecture
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                       Your Restaurant Site                       │
+│                                                                  │
+│   Astro Framework (Live Collections · Sessions · Middleware)     │
+│                                                                  │
+│  ┌────────────┐  ┌────────────┐  ┌────────────┐  ┌───────────┐  │
+│  │  Content   │  │   Admin    │  │    MCP     │  │  Plugins  │  │
+│  │  Engine    │  │   Panel    │  │   Server   │  │           │  │
+│  └────────────┘  └────────────┘  └────────────┘  └───────────┘  │
+│  ┌────────────┐  ┌────────────┐  ┌────────────┐  ┌───────────┐  │
+│  │ Site       │  │  Entity    │  │   HITL     │  │   CLI     │  │
+│  │ Context    │  │ Resolution │  │  Reviews   │  │           │  │
+│  └────────────┘  └────────────┘  └────────────┘  └───────────┘  │
+│                                                                  │
+│  Data Layer: SQLite / libSQL / PostgreSQL ←→ Local / S3 Storage  │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+### Core Capabilities
+
+| Category | What It Does |
+|---|---|
+| **MCP Server** | 50+ tools for AI agents to interact with content, schema, media, search, taxonomies, menus, and site context |
+| **Site Context Engine** | Versioned operational knowledge (brand voice, seasonal strategy, policies) — agents consult before acting |
+| **Content Engine** | Structured collections with typed fields, revisions, drafts, scheduled publishing, and full-text search |
+| **Entity Resolution** | Natural-language references ("the spring lamb special") resolve to exact content items |
+| **Human-in-the-Loop** | Review requests ensure AI-generated changes get human approval before going live |
+| **Admin Panel** | Visual schema builder, rich text editor (TipTap/Portable Text), media library, menu builder |
+| **Plugin System** | Lifecycle hooks, KV storage, settings, admin pages, dashboard widgets, custom block types |
+| **CLI** | Programmatic site management for content, schema, media, deployment — designed for both humans and AI agents |
 
 ## Installation
 
+```shell
+npm create dineway@latest
+```
+
+Or add to an existing Astro project:
+
 ```shell
 npm install dineway
 ```
 
-## Features
-
-- **MCP Server** - AI agents interact with your site's content, schema, and context through the open Model Context Protocol
-- **Site Context Engine** - Versioned operational knowledge (brand voice, seasonal strategy, policies) that agents consult before acting
-- **Content Management** - Structured collections, fields, Live Collections integration
-- **Entity Resolution** - Natural-language references resolve to exact content items
-- **Review Requests** - Human-in-the-loop approval for AI-generated changes
-- **Media Library** - Upload via signed URLs, S3-compatible storage
-- **Full-Text Search** - FTS5 with Porter stemming, per-collection config
-- **Navigation Menus** - Hierarchical menus with URL resolution
-- **Taxonomies** - Categories, tags, custom taxonomies
-- **Widget Areas** - Content, menu, and component widgets
-- **Sections** - Reusable content blocks
-- **Plugin System** - Hooks, storage, settings, admin pages
+## CLI
+
+The Dineway CLI (`dineway`) manages projects and instances. Commands fall into three categories:
+
+- **Local commands** — work directly on local project files or a SQLite file, no running server needed: `init`, `dev`, `seed`, `export-seed`, `auth secret`
+- **Deployment commands** — orchestrate platform CLIs or generate provider files: `deploy`
+- **Remote commands** — talk to a running Dineway instance via HTTP: `types`, `login`, `logout`, `whoami`, `content`, `schema`, `media`, `search`, `taxonomy`, `menu`
+
+### Authentication
+
+Remote commands resolve auth automatically in this order:
+
+1. `--token` flag
+2. `DINEWAY_TOKEN` env var
+3. Stored credentials from `dineway login`
+4. Dev bypass (localhost only — no token needed)
+
+For local dev servers, just run the command — auth is handled automatically. For remote instances, run `dineway login --url https://my-site.example.com` first.
 
 ## Quick Start
 
-```typescript
-// astro.config.mjs
-import { defineConfig } from "astro/config";
-import dineway, { local } from "dineway/astro";
-import { sqlite } from "dineway/db";
-
-export default defineConfig({
-	integrations: [
-		dineway({
-			database: sqlite({ url: "file:./data.db" }),
-			storage: local({
-				directory: "./uploads",
-				baseUrl: "/_dineway/api/media/file",
-			}),
-		}),
-	],
-});
+### Create and Run
+
+```bash
+# Create a new Dineway site
+npm create dineway@latest my-restaurant
+cd my-restaurant
+npm install
+
+# Start the dev server (runs migrations automatically)
+npx dineway dev
+
+# Open the admin panel at http://localhost:4321/_dineway/admin
+# Complete the Setup Wizard to create your first admin account
 ```
 
-```typescript
-// src/live.config.ts
-import { defineLiveCollection } from "astro:content";
-import { dinewayLoader } from "dineway/runtime";
+### Seed a Site
+
+Apply a seed file to bootstrap collections, menus, taxonomies, and content:
+
+```bash
+npx dineway seed .dineway/seed.json
+```
+
+Export the current database as a reusable seed:
 
-export const collections = {
-	_dineway: defineLiveCollection({ loader: dinewayLoader() }),
-};
+```bash
+npx dineway export-seed > seed.json
+npx dineway export-seed --with-content > seed-with-content.json
 ```
 
-## API
+### Manage Content via CLI
+
+The CLI is designed for both humans and AI agents. Create and update auto-publish by default for immediate read-after-write consistency.
+
+```bash
+# List content
+npx dineway content list posts
+npx dineway content list posts --status published --limit 10
+
+# Get a single item (Portable Text fields converted to markdown)
+npx dineway content get posts my-post-slug
+
+# Create content (auto-publishes by default)
+npx dineway content create posts --data '{"title": "Spring Menu", "body": "# New Dishes"}'
+npx dineway content create posts --file post.json --slug spring-menu
+
+# Update content (requires --rev from a prior get)
+npx dineway content update posts 01ABC123 --rev MToyMDI2... --data '{"title": "Updated"}'
+
+# Lifecycle
+npx dineway content publish posts 01ABC123
+npx dineway content unpublish posts 01ABC123
+npx dineway content schedule posts 01ABC123 --at 2026-03-01T09:00:00Z
+```
+
+### Manage Schema
+
+```bash
+# List collections
+npx dineway schema list
+
+# Create a collection
+npx dineway schema create menu-items --label "Menu Items"
+
+# Add fields
+npx dineway schema add-field menu-items price --type number --required
+npx dineway schema add-field menu-items description --type text --label "Description"
+npx dineway schema add-field menu-items photo --type image
+```
+
+Field types: `string`, `text`, `number`, `integer`, `boolean`, `datetime`, `image`, `reference`, `portableText`, `json`.
+
+### Media, Search, Taxonomies, and Menus
+
+```bash
+# Upload media
+npx dineway media upload ./dish-photo.jpg --alt "Grilled lamb" --caption "Spring special"
+
+# Search content
+npx dineway search "lamb" --collection menu-items --limit 5
+
+# Manage taxonomies
+npx dineway taxonomy list
+npx dineway taxonomy add-term categories --name "Seasonal" --slug seasonal
+
+# View menus
+npx dineway menu list
+npx dineway menu get primary
+```
+
+### Generate TypeScript Types
+
+```bash
+npx dineway types
+```
+
+Writes `.dineway/types.ts` and `.dineway/schema.json` for full type safety in your Astro pages.
+
+### Deploy
+
+One-command deployment to any Node.js host:
+
+```bash
+npx dineway deploy railway    # generates railway.json, runs railway up
+npx dineway deploy docker     # generates Dockerfile + .dockerignore
+npx dineway deploy fly        # generates Fly config, runs fly deploy
+npx dineway deploy gcp        # experimental: gcloud run deploy
+```
+
+### JSON Output
+
+All CLI commands support `--json` for machine-readable output. Auto-enabled when stdout is piped:
+
+```bash
+npx dineway content list posts --json | jq '.items[].slug'
+ID=$(npx dineway content create posts --data '{"title":"Hello"}' --json | jq -r '.id')
+```
+
+## Querying Content in Astro Pages
+
+Use Dineway's query functions in your Astro components:
 
 ```typescript
 import {
@@ -63,30 +202,17 @@ import {
 	getSiteSettings,
 	getMenu,
 	getTaxonomyTerms,
-	getWidgetArea,
 	search,
 } from "dineway";
 
-// Content
-const { entries } = await getDinewayCollection("posts");
-const { entry } = await getDinewayEntry("posts", "hello-world");
-
-// Site settings
+const { entries: menuItems } = await getDinewayCollection("menu-items");
+const { entry: dish } = await getDinewayEntry("menu-items", "spring-lamb");
 const settings = await getSiteSettings();
-
-// Navigation
 const menu = await getMenu("primary");
-
-// Taxonomies
 const categories = await getTaxonomyTerms("categories");
-
-// Widgets
-const sidebar = await getWidgetArea("sidebar");
-
-// Search
-const results = await search("hello world", { collections: ["posts"] });
+const results = await search("lamb", { collections: ["menu-items"] });
 ```
 
 ## Documentation
 
-See the [documentation docs](../../docs/src/content/docs/index.mdx) for guides, API reference, and plugin development.
+Full documentation, guides, and API reference: [docs](../../docs/src/content/docs/index.mdx)

package/dist/astro/index.mjs

@@ -1,4 +1,4 @@
-import { n as VERSION, t as COMMIT } from "../version-hmtC3Cmv.mjs";
+import { n as VERSION, t as COMMIT } from "../version-DxxaFHZ_.mjs";
 import { t as defaultSeed } from "../default-VjJyuuG9.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync } from "node:fs";

package/dist/astro/middleware.mjs

@@ -4,7 +4,7 @@ import "../connection-BCNICDWN.mjs";
 import { t as validateIdentifier } from "../validate-VPnKoIzW.mjs";
 import { a as isSqlite } from "../dialect-helpers-DhTzaUxP.mjs";
 import { r as runMigrations } from "../runner-DWZm2KQm.mjs";
-import { $t as validateRev, B as DEV_CONSOLE_EMAIL_PLUGIN_ID, Bt as handleContentDuplicate, Ct as handleMediaDelete, Dt as handleRevisionGet, Et as handleMediaUpdate, Ft as handleContentCountScheduled, G as resolveExclusiveHooks, Gt as handleContentPermanentDelete, H as EmailPipeline, Ht as handleContentGetIncludingTrashed, It as handleContentCountTrashed, J as sanitizeHeadersForSandbox, Jt as handleContentSchedule, K as CronExecutor, Kt as handleContentPublish, Lt as handleContentCreate, Mt as hashString, Nt as PluginStateRepository, Ot as handleRevisionList, Pt as handleContentCompare, Qt as handleContentUpdate, Rt as handleContentDelete, St as handleMediaCreate, Tt as handleMediaList, Ut as handleContentList, V as devConsoleEmailDeliver, Vt as handleContentGet, W as createHookPipeline, Wt as handleContentListTrashed, X as definePlugin, Xt as handleContentUnpublish, Y as getTrustedProxyHeaders, Yt as handleContentTranslations, Zt as handleContentUnschedule, kt as handleRevisionRestore, pt as after, q as extractRequestMeta, qt as handleContentRestore, vt as createPluginBundleStore, wt as handleMediaGet, z as PluginRouteRegistry, zt as handleContentDiscardDraft } from "../search-BApX1xhM.mjs";
+import { $t as validateRev, B as DEV_CONSOLE_EMAIL_PLUGIN_ID, Bt as handleContentDuplicate, Ct as handleMediaDelete, Dt as handleRevisionGet, Et as handleMediaUpdate, Ft as handleContentCountScheduled, G as resolveExclusiveHooks, Gt as handleContentPermanentDelete, H as EmailPipeline, Ht as handleContentGetIncludingTrashed, It as handleContentCountTrashed, J as sanitizeHeadersForSandbox, Jt as handleContentSchedule, K as CronExecutor, Kt as handleContentPublish, Lt as handleContentCreate, Mt as hashString, Nt as PluginStateRepository, Ot as handleRevisionList, Pt as handleContentCompare, Qt as handleContentUpdate, Rt as handleContentDelete, St as handleMediaCreate, Tt as handleMediaList, Ut as handleContentList, V as devConsoleEmailDeliver, Vt as handleContentGet, W as createHookPipeline, Wt as handleContentListTrashed, X as definePlugin, Xt as handleContentUnpublish, Y as getTrustedProxyHeaders, Yt as handleContentTranslations, Zt as handleContentUnschedule, kt as handleRevisionRestore, pt as after, q as extractRequestMeta, qt as handleContentRestore, vt as createPluginBundleStore, wt as handleMediaGet, z as PluginRouteRegistry, zt as handleContentDiscardDraft } from "../search-Hlm6g8Td.mjs";
 import { r as RevisionRepository } from "../content-DWi4d0rT.mjs";
 import "../base64-F8-DUraK.mjs";
 import "../types-BawVha09.mjs";
@@ -17,7 +17,7 @@ import { i as setI18nConfig } from "../config-BXwuX8Bx.mjs";
 import { i as FTSManager, n as SchemaRegistry } from "../registry-C0zjeB9P.mjs";
 import { n as getDb } from "../loader-sMG4TZ-u.mjs";
 import "../request-cache-Dk5qPSOx.mjs";
-import { n as VERSION, t as COMMIT } from "../version-hmtC3Cmv.mjs";
+import { n as VERSION, t as COMMIT } from "../version-DxxaFHZ_.mjs";
 import "../taxonomies-1s5PaS_8.mjs";
 import { r as normalizeManifestRoute } from "../manifest-schema-D1MSVnoI.mjs";
 import { a as invalidateUrlPatternCache } from "../query-kDmwCsHh.mjs";

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { getRequestContext, runWithContext } from "./request-context.mjs";
 import { t as DinewayDatabaseError } from "./connection-BCNICDWN.mjs";
 import "./dialect-helpers-DhTzaUxP.mjs";
 import { t as getMigrationStatus } from "./runner-DWZm2KQm.mjs";
-import { $ as createFilePreviewMiddleware, A as isStandardPluginDefinition, At as generateManifest, Bt as handleContentDuplicate, C as getAllSources, Ct as handleMediaDelete, D as probeUrl, Dt as handleRevisionGet, E as getUrlSources, Et as handleMediaUpdate, F as createNoopSandboxRunner, Ft as handleContentCountScheduled, Gt as handleContentPermanentDelete, Ht as handleContentGetIncludingTrashed, I as PluginManager, It as handleContentCountTrashed, Jt as handleContentSchedule, Kt as handleContentPublish, L as createPluginManager, Lt as handleContentCreate, M as createNodeSandboxRunner, Mt as hashString, N as NoopSandboxRunner, O as registerSource, Ot as handleRevisionList, P as SandboxNotAvailableError, Pt as handleContentCompare, Q as parseWxrString, Qt as handleContentUpdate, R as PluginRouteError, Rt as handleContentDelete, S as clearSources, St as handleMediaCreate, T as getSource, Tt as handleMediaList, U as HookPipeline, Ut as handleContentList, Vt as handleContentGet, W as createHookPipeline, Wt as handleContentListTrashed, X as definePlugin, Xt as handleContentUnpublish, Yt as handleContentTranslations, Z as parseWxr, Zt as handleContentUnschedule, _ as buildPreviewUrl, _t as sanitizeHref, a as search, at as SessionDatabaseLimitError, b as parseWxrDate, bt as getSections, c as getWidgetArea, ct as buildPreviewSignatureHeader, d as getMenu, dt as signPreviewUrl, en as portableText, et as renderPreviewToolbar, f as getMenus, ft as verifyPreviewSignature, g as isPreviewRequest, gt as isSafeHref, h as getPreviewToken, ht as prosemirrorToPortableText, i as getSuggestions, it as FileSessionDatabaseFactory, j as NodeSandboxRunner, jt as computeContentHash, k as importReusableBlocksAsSections, kt as handleRevisionRestore, l as getWidgetAreas, lt as defaultPreviewSidecarClient, m as getComments, mt as portableTextToProsemirror, n as extractSearchableFields, nn as image, nt as dropSessionDatabaseTables, o as searchCollection, ot as isBlockedInPreview, p as getCommentCount, pt as after, qt as handleContentRestore, r as getSearchStats, rt as getAppliedSnapshotMeta, s as searchWithDb, st as renderPreviewLoadingPage, t as extractPlainText, tn as reference, tt as applySnapshotToDatabase, u as getWidgetComponents, ut as parsePreviewSignatureHeader, v as getPreviewUrl, w as getFileSources, wt as handleMediaGet, x as wxrSource, xt as getCollectionInfo, y as wordpressRestSource, yt as getSection, zt as handleContentDiscardDraft } from "./search-BApX1xhM.mjs";
+import { $ as createFilePreviewMiddleware, A as isStandardPluginDefinition, At as generateManifest, Bt as handleContentDuplicate, C as getAllSources, Ct as handleMediaDelete, D as probeUrl, Dt as handleRevisionGet, E as getUrlSources, Et as handleMediaUpdate, F as createNoopSandboxRunner, Ft as handleContentCountScheduled, Gt as handleContentPermanentDelete, Ht as handleContentGetIncludingTrashed, I as PluginManager, It as handleContentCountTrashed, Jt as handleContentSchedule, Kt as handleContentPublish, L as createPluginManager, Lt as handleContentCreate, M as createNodeSandboxRunner, Mt as hashString, N as NoopSandboxRunner, O as registerSource, Ot as handleRevisionList, P as SandboxNotAvailableError, Pt as handleContentCompare, Q as parseWxrString, Qt as handleContentUpdate, R as PluginRouteError, Rt as handleContentDelete, S as clearSources, St as handleMediaCreate, T as getSource, Tt as handleMediaList, U as HookPipeline, Ut as handleContentList, Vt as handleContentGet, W as createHookPipeline, Wt as handleContentListTrashed, X as definePlugin, Xt as handleContentUnpublish, Yt as handleContentTranslations, Z as parseWxr, Zt as handleContentUnschedule, _ as buildPreviewUrl, _t as sanitizeHref, a as search, at as SessionDatabaseLimitError, b as parseWxrDate, bt as getSections, c as getWidgetArea, ct as buildPreviewSignatureHeader, d as getMenu, dt as signPreviewUrl, en as portableText, et as renderPreviewToolbar, f as getMenus, ft as verifyPreviewSignature, g as isPreviewRequest, gt as isSafeHref, h as getPreviewToken, ht as prosemirrorToPortableText, i as getSuggestions, it as FileSessionDatabaseFactory, j as NodeSandboxRunner, jt as computeContentHash, k as importReusableBlocksAsSections, kt as handleRevisionRestore, l as getWidgetAreas, lt as defaultPreviewSidecarClient, m as getComments, mt as portableTextToProsemirror, n as extractSearchableFields, nn as image, nt as dropSessionDatabaseTables, o as searchCollection, ot as isBlockedInPreview, p as getCommentCount, pt as after, qt as handleContentRestore, r as getSearchStats, rt as getAppliedSnapshotMeta, s as searchWithDb, st as renderPreviewLoadingPage, t as extractPlainText, tn as reference, tt as applySnapshotToDatabase, u as getWidgetComponents, ut as parsePreviewSignatureHeader, v as getPreviewUrl, w as getFileSources, wt as handleMediaGet, x as wxrSource, xt as getCollectionInfo, y as wordpressRestSource, yt as getSection, zt as handleContentDiscardDraft } from "./search-Hlm6g8Td.mjs";
 import { i as decodeSlug, t as ContentRepository } from "./content-DWi4d0rT.mjs";
 import "./base64-F8-DUraK.mjs";
 import { t as DinewayValidationError } from "./types-BawVha09.mjs";

package/dist/{search-BApX1xhM.mjs → search-Hlm6g8Td.mjs}

@@ -16,7 +16,7 @@ import { i as invalidateRedirectCache } from "./cache-BdSY-gQN.mjs";
 import { i as FTSManager, n as SchemaRegistry } from "./registry-C0zjeB9P.mjs";
 import { n as getDb } from "./loader-sMG4TZ-u.mjs";
 import { n as requestCached } from "./request-cache-Dk5qPSOx.mjs";
-import { n as VERSION, t as COMMIT } from "./version-hmtC3Cmv.mjs";
+import { n as VERSION, t as COMMIT } from "./version-DxxaFHZ_.mjs";
 import { i as pluginManifestSchema } from "./manifest-schema-D1MSVnoI.mjs";
 import { t as generatePreviewToken } from "./tokens-CJz9ubV6.mjs";
 import BetterSqlite3 from "better-sqlite3";

package/dist/version-DxxaFHZ_.mjs

@@ -0,0 +1,6 @@
+//#region src/version.ts
+const VERSION = "0.1.8";
+const COMMIT = "5e088838";
+
+//#endregion
+export { VERSION as n, COMMIT as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dineway",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Agentic Website builder for restaurants — structured content meets AI via the Model Context Protocol",
   "type": "module",
   "main": "dist/index.mjs",

package/dist/version-hmtC3Cmv.mjs

@@ -1,6 +0,0 @@
-//#region src/version.ts
-const VERSION = "0.1.6";
-const COMMIT = "e16302a0";
-
-//#endregion
-export { VERSION as n, COMMIT as t };