@letterstory/design 0.1.7 → 0.1.10

package/PRINCIPLES.md

@@ -2,7 +2,7 @@
 
 # Letterstory design principles
 
-## The four principles
+## The six principles
 
 1. **Primitives + intelligence, never a baked opinion.** Every surface is an unopinionated
    substrate (data structures, one pipeline, storable as plain data) plus an intelligence layer
@@ -44,6 +44,23 @@
    need does not exist, add it there first, then use it. Cross-feature imports of another
    feature's private module are an ESLint error.
 
+5. **Agentic coverage via API/CLI/MCP.** A customer's own agent (a long-running background
+   agent monitoring their account — e.g. "Hermes") must be able to watch accounts, activity,
+   and progress 24/7 through the API/MCP, not just a human through the UI. If an agent can't
+   do something agentically that the UI supports, that's a blind spot — the missing projection
+   principle 3 already names. The asymmetry runs both ways: an internal-only tool that gives
+   the team a capability customers can't reach via API (a staff dashboard, an admin-only
+   feed) is a design flaw to fix, not a shortcut to keep. Precedent gap:
+   `src/lib/phantom-access/recent-activity.ts` powers a UI-only "what's hitting my fleet right
+   now" feed with no MCP/CLI projection — first candidate to close (see todo.md).
+
+6. **Every primitive launches through one workflow: Build → Access → Test → Onboard → Billing.**
+   Build the primitive; expose it through the API/MCP/CLI gateways (principle 3 — no separate
+   surface-specific launch path); test it end-to-end, e.g. via Claude Code; onboard it (docs,
+   org enablement); wire billing. Primitives stay composable and independent — easy to swap in
+   or out — even where they share logic with the rest of the stack. Writing Kernels is a
+   primitive; it went through this workflow.
+
 ## The two review questions
 
 Applied to every PR (from `docs/architecture/README.md`):

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/design",
-	"version": "0.1.7",
+	"version": "0.1.10",
 	"description": "Letterstory design tokens, the phantom theme registry, and the design principles — one source for every Letterstory repo.",
 	"type": "module",
 	"license": "UNLICENSED",

package/themes.d.ts

@@ -66,7 +66,8 @@ export type PhantomBlogTheme =
 	| "vitrine"
 	| "commons"
 	| "blitz"
-	| "quarto";
+	| "quarto"
+	| "stark";
 
 export interface PhantomBlogThemeGroupEntry {
 	readonly id: PhantomBlogThemeGroup;

package/themes.json

@@ -434,6 +434,13 @@
 			"hint": "Serif review journal, three-column newspaper front, warm paper",
 			"group": "publication",
 			"tags": ["editorial", "serif", "review", "newspaper", "classic", "magazine"]
+		},
+		{
+			"value": "stark",
+			"label": "Stark",
+			"hint": "Minimal monospace image archive, square-thumbnail grid, near-white",
+			"group": "publication",
+			"tags": ["minimal", "monospace", "gallery", "archive", "image", "modern"]
 		}
 	]
 }