@treeseed/core 0.8.19 → 0.9.0

package/dist/components/ui/shell/AppShell.astro

@@ -5,9 +5,11 @@ import '../../../styles/ui.css';
 import '../../../styles/forms.css';
 import '../../../styles/app-shell.css';
 import ThemeScript from '../theme/ThemeScript.astro';
+import ThemeMenu from '../theme/ThemeMenu.astro';
 import RailNav from './RailNav.astro';
 import BottomNav from './BottomNav.astro';
 import TopBar from './TopBar.astro';
+import ShellIconLink from './ShellIconLink.astro';
 import Button from '../forms/Button.astro';
 import DevWatchReload from '../../DevWatchReload.astro';
 import type { ButtonAction } from '../types.js';
@@ -64,11 +66,13 @@ const {
 		<a class="ts-skip-link" href="#main-content">Skip to content</a>
 		<div class="ts-app-shell">
 			<aside class="ts-app-shell__rail">
-				<TopBar brand={brand} />
-				<div class="ts-app-shell__rail-context">
-					<slot name="railContext" />
+				<div class="ts-app-shell__rail-scroll">
+					<TopBar brand={brand} />
+					<div class="ts-app-shell__rail-context">
+						<slot name="railContext" />
+					</div>
+					<RailNav items={navItems} currentPath={currentPath} />
 				</div>
-				<RailNav items={navItems} currentPath={currentPath} />
 				{quickActions.length > 0 ? (
 					<div class="ts-app-shell__quick-actions">
 						<p class="ts-app-shell__eyebrow">Quick actions</p>
@@ -91,6 +95,10 @@ const {
 			</aside>
 			<main class="ts-app-shell__main" id="main-content">
 				<TopBar brand={brand} class="ts-app-shell__mobile-top">
+					<Fragment slot="actions">
+						<ThemeMenu selectedScheme={appearance.scheme} selectedMode={appearance.mode} />
+						<ShellIconLink href="/" label="Book home" icon="book" />
+					</Fragment>
 				</TopBar>
 				<header class="ts-app-shell__header">
 					<div class="ts-app-shell__title">
@@ -98,6 +106,10 @@ const {
 						<p>{description}</p>
 					</div>
 					<div class="ts-app-shell__header-actions">
+						<div class="ts-shell-utility-actions">
+							<ThemeMenu selectedScheme={appearance.scheme} selectedMode={appearance.mode} />
+							<ShellIconLink href="/" label="Book home" icon="book" />
+						</div>
 						<slot name="headerAction" />
 					</div>
 				</header>

package/dist/components/ui/shell/BottomNav.astro

@@ -19,10 +19,17 @@ const {
 	class: className,
 } = Astro.props as Props;
 
+function normalizePath(path: string) {
+	if (path.length <= 1) return path;
+	return path.replace(/\/+$/u, '');
+}
+
 function isCurrentPath(href: string) {
-	if (href === '/') return currentPath === '/';
-	if (href.endsWith('/')) return currentPath === href || currentPath.startsWith(href);
-	return currentPath === href || currentPath.startsWith(`${href}/`);
+	const current = normalizePath(currentPath);
+	const target = normalizePath(href);
+	if (target === '/') return current === '/';
+	if (target === '/app') return current === '/app';
+	return current === target || current.startsWith(`${target}/`);
 }
 ---
 

package/dist/components/ui/shell/RailNav.astro

@@ -19,10 +19,17 @@ const {
 	class: className,
 } = Astro.props as Props;
 
+function normalizePath(path: string) {
+	if (path.length <= 1) return path;
+	return path.replace(/\/+$/u, '');
+}
+
 function isCurrentPath(href: string) {
-	if (href === '/') return currentPath === '/';
-	if (href.endsWith('/')) return currentPath === href || currentPath.startsWith(href);
-	return currentPath === href || currentPath.startsWith(`${href}/`);
+	const current = normalizePath(currentPath);
+	const target = normalizePath(href);
+	if (target === '/') return current === '/';
+	if (target === '/app') return current === '/app';
+	return current === target || current.startsWith(`${target}/`);
 }
 ---
 

package/dist/components/ui/shell/ShellIconLink.astro

@@ -0,0 +1,30 @@
+---
+interface Props {
+	href: string;
+	label: string;
+	icon: 'book' | 'manager';
+}
+
+const { href, label, icon } = Astro.props as Props;
+---
+
+<a
+	href={href}
+	aria-label={label}
+	title={label}
+	class="ts-public-shell__icon-link ts-public-shell__icon-link--stroke"
+>
+	{icon === 'manager' ? (
+		<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" aria-hidden="true" focusable="false">
+			<path d="M12 15.25a3.25 3.25 0 1 0 0-6.5 3.25 3.25 0 0 0 0 6.5Z" />
+			<path d="M19.43 12.98c.04-.32.07-.65.07-.98s-.02-.66-.07-.98l2.05-1.6-2-3.46-2.42.98a7.65 7.65 0 0 0-1.7-.98L15 3.38h-4l-.36 2.58c-.6.24-1.17.57-1.7.98l-2.42-.98-2 3.46 2.05 1.6c-.04.32-.07.65-.07.98s.02.66.07.98l-2.05 1.6 2 3.46 2.42-.98c.52.41 1.09.74 1.7.98l.36 2.58h4l.36-2.58c.6-.24 1.17-.57 1.7-.98l2.42.98 2-3.46-2.05-1.6Z" />
+		</svg>
+	) : (
+		<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" aria-hidden="true" focusable="false">
+			<path d="M4.75 5.75A2.75 2.75 0 0 1 7.5 3h11.75v16.25H7.5a2.75 2.75 0 0 0-2.75 2.75V5.75Z" />
+			<path d="M7.5 19.25h11.75" />
+			<path d="M8.25 7.25h7.5" />
+			<path d="M8.25 10.75h6" />
+		</svg>
+	)}
+</a>

package/dist/content-config.d.ts

@@ -5,6 +5,7 @@ export declare function createTreeseedTenantCollections(manifestPath?: string):
 	objectives: any;
 	people: any;
 	agents: any;
+	agent_tests?: any;
 	books: any;
 	docs: any;
 	workdays?: any;

package/dist/content.js

@@ -2,6 +2,7 @@ import { defineCollection, reference } from "astro:content";
 import { z } from "astro/zod";
 import { glob } from "astro/loaders";
 import { existsSync, readdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 import { AGENT_CLI_ALLOW_TOOLS } from "@treeseed/sdk/types/agents";
 import { loadTreeseedPluginRuntime } from "@treeseed/sdk/platform/plugins";
 import { loadTreeseedDeployConfig } from "@treeseed/sdk/platform/deploy-config";
@@ -23,7 +24,7 @@ const statusValues = ["live", "in progress", "exploratory", "planned", "speculat
 const pageLayoutValues = ["article", "bridge"];
 const questionTypeValues = ["research", "implementation", "strategy", "evaluation"];
 const proposalTypeValues = ["strategy", "policy", "implementation", "research"];
-const decisionTypeValues = ["approved", "rejected", "deferred", "superseded"];
+const decisionTypeValues = ["approved", "rejected", "deferred", "request_changes", "superseded"];
 const timeHorizonValues = ["near-term", "mid-term", "long-term"];
 const runtimeStatusValues = ["active", "experimental", "dormant"];
 const agentTriggerTypeValues = ["schedule", "message", "follow", "startup"];
@@ -362,6 +363,15 @@ function createTreeseedCollections(tenantConfig, { docsLoader, docsSchema }) {
     outputs: agentOutputSchema.default({}),
     governance: agentGovernanceSchema.optional()
   }));
+  const agentTestSchema = z.object({
+    id: z.string(),
+    agent: z.string(),
+    kind: z.enum(["spec", "handler", "message_chain", "manager_worker", "workday", "api", "ui"]),
+    fixture: z.string().optional(),
+    trigger: z.record(z.any()).default({}),
+    expect: z.record(z.any()).default({}),
+    tags: z.array(z.string()).default([])
+  });
   const bookSchema = z.preprocess((value) => preprocessAliasedRecord(bookFieldAliases, value), z.object({
     order: z.number().int().nonnegative(),
     slug: z.string(),
@@ -450,7 +460,7 @@ function createTreeseedCollections(tenantConfig, { docsLoader, docsSchema }) {
     completedAt: z.coerce.date().optional(),
     lastErrorCode: z.string().nullable().optional(),
     lastErrorMessage: z.string().nullable().optional(),
-    lastEventKind: z.string().optional(),
+    lastEventKind: z.string().nullable().optional(),
     outputCount: z.number().int().optional(),
     changedFiles: z.array(z.string()).default([])
   });
@@ -528,6 +538,13 @@ function createTreeseedCollections(tenantConfig, { docsLoader, docsSchema }) {
       schema: docsCollectionProvider.schema
     })
   };
+  const agentTestsRoot = resolve(dirname(tenantConfig.content.agents), "agent-tests");
+  if (existsSync(agentTestsRoot)) {
+    collections.agent_tests = defineCollection({
+      loader: optionalMarkdownGlob(agentTestsRoot),
+      schema: agentTestSchema
+    });
+  }
   if (tenantConfig.content.workdays) {
     collections.workdays = defineCollection({
       loader: optionalMarkdownGlob(tenantConfig.content.workdays),

package/dist/dev.d.ts

@@ -32,11 +32,13 @@ export type TreeseedIntegratedDevOptions = {
     webPort?: number;
     apiHost?: string;
     apiPort?: number;
+    webRuntime?: TreeseedLocalRuntimeMode;
     setupMode?: TreeseedIntegratedDevSetupMode;
     feedbackMode?: TreeseedIntegratedDevFeedbackMode;
     openMode?: TreeseedIntegratedDevOpenMode;
     plan?: boolean;
     reset?: boolean;
+    force?: boolean;
     json?: boolean;
     includeServices?: boolean;
     projectId?: string;
@@ -97,6 +99,7 @@ export type TreeseedIntegratedDevPlan = {
     readyChecks: TreeseedIntegratedDevReadinessCheck[];
     watchEntries: TreeseedIntegratedDevWatchEntry[];
     commands: TreeseedIntegratedDevCommand[];
+    logPath: string;
     localRuntimes: Record<string, TreeseedLocalRuntimeSelection>;
     restartPolicy: {
         initialBackoffMs: number;
@@ -127,6 +130,13 @@ type TreeseedIntegratedDevDependencies = {
     startWatch: WatchStarter;
     removePath: (path: string) => void;
     stopMailpitContainers: () => boolean;
+    inspectPortOwners: (ports: readonly number[]) => TreeseedDevPortOwner[];
+};
+export type TreeseedDevPortOwner = {
+    port: number;
+    pid: number | null;
+    processName?: string;
+    detail: string;
 };
 export declare function createTreeseedIntegratedDevResetPlan(options: {
     tenantRoot: string;

package/dist/dev.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { spawn, spawnSync } from "node:child_process";
 import { createRequire } from "node:module";
 import { dirname, isAbsolute, resolve, sep } from "node:path";
@@ -32,7 +32,8 @@ const TREESEED_DEFAULT_LOCAL_SMTP_HOST = "127.0.0.1";
 const TREESEED_DEFAULT_LOCAL_SMTP_PORT = 1025;
 const TREESEED_DEFAULT_MAILPIT_UI_PORT = 8025;
 const DEV_RELOAD_FILE = "public/__treeseed/dev-reload.json";
-const DEV_RUNTIME_FILE = ".treeseed/generated/dev/runtime.json";
+const DEV_RUNTIME_DIR = ".treeseed/generated/dev";
+const DEV_RUNTIME_LEGACY_FILE = ".treeseed/generated/dev/runtime.json";
 const DEFAULT_READINESS_TIMEOUT_MS = 9e4;
 const DEFAULT_SETUP_STEP_TIMEOUT_MS = 3e5;
 const DEFAULT_PROCESS_READY_GRACE_MS = 1200;
@@ -132,10 +133,10 @@ function fallbackWebProviderFromDeployConfig(deployConfig) {
   const record = deployConfig && typeof deployConfig === "object" ? deployConfig : {};
   return normalizeProvider(record.providers?.deploy, "local");
 }
-function selectWebLocalRuntime(surfaceConfig, providerFallback = "local") {
+function selectWebLocalRuntime(surfaceConfig, providerFallback = "local", overrideRuntime) {
   const record = surfaceConfig && typeof surfaceConfig === "object" ? surfaceConfig : {};
   const provider = normalizeProvider(record.provider, providerFallback);
-  const requested = normalizeLocalRuntimeMode(record.local?.runtime);
+  const requested = overrideRuntime ?? normalizeLocalRuntimeMode(record.local?.runtime);
   if (provider === "cloudflare" && requested !== "local") {
     return {
       requested,
@@ -151,7 +152,7 @@ function selectWebLocalRuntime(surfaceConfig, providerFallback = "local") {
     requested,
     provider,
     selected: "astro-local",
-    reason: requested === "local" ? "Configured to use the full local Astro runtime." : `Provider "${provider}" has no provider-local web runtime; using Astro local.`
+    reason: overrideRuntime === "local" ? "CLI override selected the full local Astro runtime for faster UI development." : requested === "local" ? "Configured to use the full local Astro runtime." : `Provider "${provider}" has no provider-local web runtime; using Astro local.`
   };
 }
 function loadDevDeployConfig(tenantRoot) {
@@ -271,6 +272,30 @@ function resolveSeededLocalProjectId(persistTo, projectSlug = "market") {
     db?.close();
   }
 }
+function resolveSeededLocalTeamId(persistTo, projectId, teamSlug = "treeseed") {
+  const sqlitePath = resolveLocalD1SqlitePath(persistTo);
+  if (!sqlitePath) return null;
+  let db = null;
+  try {
+    db = new DatabaseSync(sqlitePath, { readOnly: true });
+    if (projectId) {
+      const projectRow = db.prepare(
+        `SELECT team_id FROM projects WHERE id = ? LIMIT 1`
+      ).get(projectId);
+      if (typeof projectRow?.team_id === "string" && projectRow.team_id.trim()) {
+        return projectRow.team_id.trim();
+      }
+    }
+    const teamRow = db.prepare(
+      `SELECT id FROM teams WHERE LOWER(slug) = LOWER(?) ORDER BY created_at ASC LIMIT 1`
+    ).get(teamSlug);
+    return typeof teamRow?.id === "string" && teamRow.id.trim() ? teamRow.id.trim() : null;
+  } catch {
+    return null;
+  } finally {
+    db?.close();
+  }
+}
 function createTreeseedIntegratedDevResetPlan(options) {
   if (!options.enabled) {
     return null;
@@ -529,10 +554,13 @@ function createTreeseedIntegratedDevPlan(options = {}) {
   const agentPackageRoot = resolvePackageRootEnvOverride(mergedEnv, "TREESEED_AGENT_PACKAGE_ROOT", tenantRoot) ?? resolveOptionalPackageRoot("@treeseed/agent", tenantRoot);
   const cliPackageRoot = resolveOptionalPackageRoot("@treeseed/cli", tenantRoot);
   const deployConfig = loadDevDeployConfig(tenantRoot);
-  const webLocalRuntime = selectWebLocalRuntime(deployConfig?.surfaces?.web, fallbackWebProviderFromDeployConfig(deployConfig));
+  const webLocalRuntime = selectWebLocalRuntime(deployConfig?.surfaces?.web, fallbackWebProviderFromDeployConfig(deployConfig), options.webRuntime);
   const usesCloudflareWebRuntime = webLocalRuntime.selected === "cloudflare-wrangler-local";
-  const localD1PersistTo = mergedEnv.TREESEED_API_D1_LOCAL_PERSIST_TO ?? (usesCloudflareWebRuntime ? resolve(tenantRoot, ".treeseed", "generated", "environments", "local", ".wrangler", "state", "v3", "d1") : resolve(tenantRoot, ".wrangler", "state", "v3", "d1"));
+  const usesGeneratedLocalD1State = usesCloudflareWebRuntime || webLocalRuntime.provider === "cloudflare" || selectedCommandIds.some((id) => id !== "web");
+  const localD1PersistTo = mergedEnv.TREESEED_API_D1_LOCAL_PERSIST_TO ?? (usesGeneratedLocalD1State ? resolve(tenantRoot, ".treeseed", "generated", "environments", "local", ".wrangler", "state", "v3", "d1") : resolve(tenantRoot, ".wrangler", "state", "v3", "d1"));
   const projectId = options.projectId ?? mergedEnv.TREESEED_PROJECT_ID ?? resolveSeededLocalProjectId(localD1PersistTo);
+  const resolvedHostingTeamId = teamId ?? mergedEnv.TREESEED_HOSTING_TEAM_ID;
+  const resolvedTeamId = mergedEnv.TREESEED_TEAM_ID ?? resolvedHostingTeamId ?? resolveSeededLocalTeamId(localD1PersistTo, projectId ?? null);
   const webEntrypoint = resolveNodeEntrypoint(
     sdkPackageRoot,
     "scripts/tenant-astro-command.ts",
@@ -557,13 +585,14 @@ function createTreeseedIntegratedDevPlan(options = {}) {
   const resetRequested = options.reset === true;
   const sharedEnv = {
     ...mergedEnv,
-    TREESEED_LOCAL_DEV_MODE: mergedEnv.TREESEED_LOCAL_DEV_MODE ?? "cloudflare",
+    TREESEED_LOCAL_DEV_MODE: usesCloudflareWebRuntime ? mergedEnv.TREESEED_LOCAL_DEV_MODE ?? "cloudflare" : void 0,
     TREESEED_SITE_URL: mergedEnv.TREESEED_SITE_URL ?? webUrl,
     BETTER_AUTH_URL: mergedEnv.BETTER_AUTH_URL ?? webUrl,
     TREESEED_API_BASE_URL: apiBaseUrl,
     TREESEED_MARKET_API_BASE_URL: mergedEnv.TREESEED_MARKET_API_BASE_URL ?? apiBaseUrl,
     TREESEED_PROJECT_ID: projectId ?? mergedEnv.TREESEED_PROJECT_ID,
-    TREESEED_HOSTING_TEAM_ID: teamId ?? mergedEnv.TREESEED_HOSTING_TEAM_ID,
+    TREESEED_TEAM_ID: resolvedTeamId ?? mergedEnv.TREESEED_TEAM_ID,
+    TREESEED_HOSTING_TEAM_ID: resolvedHostingTeamId ?? mergedEnv.TREESEED_HOSTING_TEAM_ID,
     TREESEED_API_D1_DATABASE_NAME: mergedEnv.TREESEED_API_D1_DATABASE_NAME ?? "SITE_DATA_DB",
     SITE_DATA_DB: mergedEnv.SITE_DATA_DB ?? "SITE_DATA_DB",
     TREESEED_API_D1_LOCAL_PERSIST_TO: localD1PersistTo,
@@ -645,6 +674,7 @@ function createTreeseedIntegratedDevPlan(options = {}) {
     readyChecks,
     watchEntries,
     commands,
+    logPath: resolve(tenantRoot, ".treeseed", "logs", `dev-${runtimeScopeKey(commands.map((command) => command.id))}.jsonl`),
     localRuntimes: {
       ...commands.some((command) => command.id === "web") ? { web: webLocalRuntime } : {},
       ...commands.some((command) => command.id === "api") ? { api: nodeLocalRuntime("Treeseed API") } : {},
@@ -686,6 +716,29 @@ function defaultProcessIsAlive(pid) {
     return false;
   }
 }
+function defaultInspectPortOwners(ports) {
+  const uniquePorts = [...new Set(ports.filter((port) => Number.isInteger(port) && port > 0))];
+  if (uniquePorts.length === 0) return [];
+  const result = spawnSync("ss", ["-ltnp"], { encoding: "utf8" });
+  if ((result.status ?? 1) !== 0) return [];
+  const lines = String(result.stdout ?? "").split(/\r?\n/u);
+  const owners = [];
+  for (const port of uniquePorts) {
+    const portPattern = new RegExp(`:${port}\\b`, "u");
+    for (const line of lines) {
+      if (!portPattern.test(line)) continue;
+      const pidMatch = line.match(/pid=(\d+)/u);
+      const nameMatch = line.match(/users:\(\("([^"]+)"/u);
+      owners.push({
+        port,
+        pid: pidMatch ? Number(pidMatch[1]) : null,
+        processName: nameMatch?.[1],
+        detail: line.trim()
+      });
+    }
+  }
+  return owners;
+}
 function defaultRemovePath(path) {
   rmSync(path, { recursive: true, force: true });
 }
@@ -782,44 +835,131 @@ function resolveLocalMachineEnv(tenantRoot) {
     return {};
   }
 }
-function devRuntimeStatePath(tenantRoot) {
-  return resolve(tenantRoot, DEV_RUNTIME_FILE);
+function devRuntimeStateDir(tenantRoot) {
+  return resolve(tenantRoot, DEV_RUNTIME_DIR);
+}
+function devRuntimeStatePath(tenantRoot, key) {
+  return resolve(devRuntimeStateDir(tenantRoot), `runtime-${key}.json`);
+}
+function legacyDevRuntimeStatePath(tenantRoot) {
+  return resolve(tenantRoot, DEV_RUNTIME_LEGACY_FILE);
 }
-function readDevRuntimeState(tenantRoot) {
+function runtimeScopeKey(commandIds) {
+  const selected = CANONICAL_COMMAND_IDS.filter((id) => commandIds.includes(id));
+  return selected.length > 0 ? selected.join("-") : "integrated";
+}
+function readDevRuntimeStateFile(path) {
   try {
-    const parsed = JSON.parse(readFileSync(devRuntimeStatePath(tenantRoot), "utf8"));
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
     if (!Number.isInteger(parsed.pid) || typeof parsed.tenantRoot !== "string" || typeof parsed.startedAt !== "string") {
       return null;
     }
+    const commandIds = Array.isArray(parsed.commandIds) ? parsed.commandIds.filter((id) => CANONICAL_COMMAND_IDS.includes(id)) : void 0;
     return {
       pid: parsed.pid,
       tenantRoot: parsed.tenantRoot,
-      startedAt: parsed.startedAt
+      startedAt: parsed.startedAt,
+      ...commandIds ? { commandIds } : {},
+      statePath: path
     };
   } catch {
     return null;
   }
 }
-function writeCurrentDevRuntimeState(tenantRoot) {
-  const outputPath = devRuntimeStatePath(tenantRoot);
+function listDevRuntimeStates(tenantRoot) {
+  const states = [];
+  const legacy = readDevRuntimeStateFile(legacyDevRuntimeStatePath(tenantRoot));
+  if (legacy) {
+    states.push(legacy);
+  }
+  try {
+    for (const entry of readdirSync(devRuntimeStateDir(tenantRoot))) {
+      if (!entry.startsWith("runtime-") || !entry.endsWith(".json")) {
+        continue;
+      }
+      const state = readDevRuntimeStateFile(resolve(devRuntimeStateDir(tenantRoot), entry));
+      if (state) {
+        states.push(state);
+      }
+    }
+  } catch {
+  }
+  return states;
+}
+function runtimeStateOverlaps(state, commandIds) {
+  if (!state.commandIds || state.commandIds.length === 0) {
+    return true;
+  }
+  return state.commandIds.some((id) => commandIds.includes(id));
+}
+function listLiveOverlappingDevRuntimeStates(tenantRoot, commandIds, processIsAlive) {
+  const live = [];
+  for (const state of listDevRuntimeStates(tenantRoot)) {
+    const statePath = state.statePath;
+    if (!statePath || !runtimeStateOverlaps(state, commandIds)) {
+      continue;
+    }
+    if (state.pid === process.pid) {
+      continue;
+    }
+    if (!processIsAlive(state.pid)) {
+      rmSync(statePath, { force: true });
+      continue;
+    }
+    live.push(state);
+  }
+  return live;
+}
+function parsePortFromUrl(value) {
+  if (!value) return null;
+  try {
+    const url = new URL(value);
+    const port = Number(url.port || (url.protocol === "https:" ? 443 : 80));
+    return Number.isInteger(port) && port > 0 ? port : null;
+  } catch {
+    return null;
+  }
+}
+function requiredDevPorts(plan) {
+  const ports = [];
+  for (const command of plan.commands) {
+    if (command.id === "web") {
+      const port = parsePortFromUrl(plan.webUrl ?? void 0);
+      if (port) ports.push(port);
+    }
+    if (command.id === "api") {
+      const port = parsePortFromUrl(plan.apiBaseUrl);
+      if (port) ports.push(port);
+    }
+  }
+  return [...new Set(ports)];
+}
+function formatPortOwner(owner) {
+  return `port ${owner.port}${owner.pid ? ` pid ${owner.pid}` : ""}${owner.processName ? ` (${owner.processName})` : ""}`;
+}
+function writeCurrentDevRuntimeState(tenantRoot, commandIds) {
+  const outputPath = devRuntimeStatePath(tenantRoot, runtimeScopeKey(commandIds));
   mkdirSync(dirname(outputPath), { recursive: true });
   writeFileSync(
     outputPath,
     `${JSON.stringify({
       pid: process.pid,
       tenantRoot,
+      commandIds,
       startedAt: (/* @__PURE__ */ new Date()).toISOString()
     }, null, 2)}
 `,
     "utf8"
   );
+  return outputPath;
 }
-function removeCurrentDevRuntimeState(tenantRoot) {
-  const state = readDevRuntimeState(tenantRoot);
+function removeCurrentDevRuntimeState(tenantRoot, commandIds) {
+  const statePath = devRuntimeStatePath(tenantRoot, runtimeScopeKey(commandIds));
+  const state = readDevRuntimeStateFile(statePath);
   if (!state || state.pid !== process.pid) {
     return;
   }
-  rmSync(devRuntimeStatePath(tenantRoot), { force: true });
+  rmSync(statePath, { force: true });
 }
 async function waitForProcessExit(pid, processIsAlive, timeoutMs) {
   const startedAt = Date.now();
@@ -831,38 +971,106 @@ async function waitForProcessExit(pid, processIsAlive, timeoutMs) {
   }
   return !processIsAlive(pid);
 }
-async function stopPreviousDevRuntime(tenantRoot, options, deps) {
-  const state = readDevRuntimeState(tenantRoot);
-  if (!state) {
-    return;
-  }
-  const statePath = devRuntimeStatePath(tenantRoot);
-  if (state.pid === process.pid) {
-    return;
-  }
-  if (!deps.processIsAlive(state.pid)) {
+async function stopPreviousDevRuntimes(tenantRoot, commandIds, options, deps) {
+  for (const state of listLiveOverlappingDevRuntimeStates(tenantRoot, commandIds, deps.processIsAlive)) {
+    const statePath = state.statePath;
+    if (!statePath) continue;
+    emitEvent(options, deps.write, {
+      type: "replace",
+      message: `Stopping previous Treeseed dev runtime (${state.pid}) before starting overlapping surfaces.`,
+      detail: { pid: state.pid, startedAt: state.startedAt, commandIds: state.commandIds ?? null }
+    });
+    try {
+      deps.killProcess(state.pid, "SIGTERM");
+    } catch {
+    }
+    if (await waitForProcessExit(state.pid, deps.processIsAlive, options.shutdownGraceMs ?? DEFAULT_SHUTDOWN_GRACE_MS)) {
+      rmSync(statePath, { force: true });
+      continue;
+    }
+    try {
+      deps.killProcess(state.pid, "SIGKILL");
+    } catch {
+    }
+    await waitForProcessExit(state.pid, deps.processIsAlive, DEFAULT_KILL_GRACE_MS);
     rmSync(statePath, { force: true });
-    return;
   }
-  emitEvent(options, deps.write, {
-    type: "replace",
-    message: `Stopping previous Treeseed dev runtime (${state.pid}) before starting a new one.`,
-    detail: { pid: state.pid, startedAt: state.startedAt }
-  });
-  try {
-    deps.killProcess(state.pid, "SIGTERM");
-  } catch {
+}
+async function stopPortOwners(owners, options, deps) {
+  const pids = [...new Set(owners.map((owner) => owner.pid).filter((pid) => Number.isInteger(pid) && pid > 0 && pid !== process.pid))];
+  for (const pid of pids) {
+    emitEvent(options, deps.write, {
+      type: "replace",
+      message: `Stopping service on required dev port (pid ${pid}).`,
+      detail: owners.filter((owner) => owner.pid === pid)
+    });
+    try {
+      deps.killProcess(pid, "SIGTERM");
+    } catch {
+    }
+    if (await waitForProcessExit(pid, deps.processIsAlive, options.shutdownGraceMs ?? DEFAULT_SHUTDOWN_GRACE_MS)) {
+      continue;
+    }
+    try {
+      deps.killProcess(pid, "SIGKILL");
+    } catch {
+    }
+    await waitForProcessExit(pid, deps.processIsAlive, DEFAULT_KILL_GRACE_MS);
   }
-  if (await waitForProcessExit(state.pid, deps.processIsAlive, options.shutdownGraceMs ?? DEFAULT_SHUTDOWN_GRACE_MS)) {
-    rmSync(statePath, { force: true });
-    return;
+}
+async function prepareDevRuntimeSlots(plan, options, deps) {
+  const commandIds = plan.commands.map((command) => command.id);
+  const liveRuntimeStates = listLiveOverlappingDevRuntimeStates(plan.tenantRoot, commandIds, deps.processIsAlive);
+  const ports = requiredDevPorts(plan);
+  const portOwners = deps.inspectPortOwners(ports).filter((owner) => owner.pid !== process.pid);
+  if (options.force !== true) {
+    if (liveRuntimeStates.length > 0 || portOwners.length > 0) {
+      emitEvent(options, deps.write, {
+        type: "error",
+        status: "existing-service",
+        message: [
+          "Treeseed dev found an existing runtime or service on a required port.",
+          "Stop it first, or rerun with --force to terminate overlapping Treeseed dev services and port owners."
+        ].join(" "),
+        detail: {
+          runtimes: liveRuntimeStates.map((state) => ({
+            pid: state.pid,
+            startedAt: state.startedAt,
+            commandIds: state.commandIds ?? null,
+            statePath: state.statePath ?? null
+          })),
+          ports: portOwners.map((owner) => ({ ...owner, label: formatPortOwner(owner) }))
+        }
+      });
+      return false;
+    }
+    return true;
   }
-  try {
-    deps.killProcess(state.pid, "SIGKILL");
-  } catch {
+  await stopPreviousDevRuntimes(plan.tenantRoot, commandIds, options, deps);
+  if (portOwners.length > 0) {
+    const ownersWithoutPid = portOwners.filter((owner) => owner.pid == null);
+    if (ownersWithoutPid.length > 0) {
+      emitEvent(options, deps.write, {
+        type: "error",
+        status: "existing-service",
+        message: `Cannot force-stop required dev ports because some listeners did not expose process ids: ${ownersWithoutPid.map(formatPortOwner).join(", ")}.`,
+        detail: ownersWithoutPid
+      });
+      return false;
+    }
+    await stopPortOwners(portOwners, options, deps);
   }
-  await waitForProcessExit(state.pid, deps.processIsAlive, DEFAULT_KILL_GRACE_MS);
-  rmSync(statePath, { force: true });
+  const remainingPortOwners = deps.inspectPortOwners(ports).filter((owner) => owner.pid !== process.pid);
+  if (remainingPortOwners.length > 0) {
+    emitEvent(options, deps.write, {
+      type: "error",
+      status: "existing-service",
+      message: `Required dev ports are still occupied after --force: ${remainingPortOwners.map(formatPortOwner).join(", ")}.`,
+      detail: remainingPortOwners
+    });
+    return false;
+  }
+  return true;
 }
 function emitEvent(options, write, event, stream = event.type === "error" ? "stderr" : "stdout") {
   if (options.json) {
@@ -875,6 +1083,20 @@ function emitEvent(options, write, event, stream = event.type === "error" ? "std
   write(`${surface} ${String(message)}
 `, stream);
 }
+function createDevLogWrite(baseWrite, logPath) {
+  mkdirSync(dirname(logPath), { recursive: true });
+  appendFileSync(logPath, `${JSON.stringify({
+    schemaVersion: 1,
+    kind: "treeseed.dev.log",
+    type: "start",
+    startedAt: (/* @__PURE__ */ new Date()).toISOString()
+  })}
+`, "utf8");
+  return (line, stream) => {
+    baseWrite(line, stream);
+    appendFileSync(logPath, line, "utf8");
+  };
+}
 function runTreeseedIntegratedDevReset(reset, options, deps) {
   if (!reset?.enabled) {
     return null;
@@ -979,6 +1201,8 @@ function writePlan(plan, options, write) {
 `, "stdout");
   }
   write(`api: ${plan.apiBaseUrl}
+`, "stdout");
+  write(`log: ${plan.logPath}
 `, "stdout");
   for (const [name, runtime] of Object.entries(plan.localRuntimes)) {
     write(`runtime ${name}: ${runtime.selected} (${runtime.provider}, requested ${runtime.requested})${runtime.reason ? ` - ${runtime.reason}` : ""}
@@ -1216,7 +1440,7 @@ function failedSetupMessage(failed) {
 }
 async function runTreeseedIntegratedDev(options = {}, deps = {}) {
   const tenantRoot = resolve(options.cwd ?? process.cwd());
-  const write = deps.write ?? defaultWrite;
+  let write = deps.write ?? defaultWrite;
   const spawnProcess = deps.spawn ?? spawn;
   const spawnSyncProcess = deps.spawnSync ?? spawnSync;
   const onSignal = deps.onSignal ?? defaultSignalRegistrar;
@@ -1228,6 +1452,7 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
   const prepareEnvironment = deps.prepareEnvironment ?? defaultPrepareEnvironment;
   const removePath = deps.removePath ?? defaultRemovePath;
   const stopMailpit = deps.stopMailpitContainers ?? stopKnownMailpitContainers;
+  const inspectPortOwners = deps.inspectPortOwners ?? defaultInspectPortOwners;
   prepareEnvironment(tenantRoot);
   const plan = createTreeseedIntegratedDevPlan({
     ...options,
@@ -1241,8 +1466,15 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
     writePlan(plan, options, write);
     return 0;
   }
-  if (readDevRuntimeState(tenantRoot)) {
-    await stopPreviousDevRuntime(tenantRoot, options, { write, killProcess, processIsAlive });
+  const commandIds = plan.commands.map((command) => command.id);
+  write = createDevLogWrite(write, plan.logPath);
+  emitEvent(options, write, {
+    type: "log",
+    message: `Writing Treeseed dev logs to ${plan.logPath}.`,
+    detail: { logPath: plan.logPath }
+  });
+  if (!await prepareDevRuntimeSlots(plan, options, { write, killProcess, processIsAlive, inspectPortOwners })) {
+    return 1;
   }
   const resetResults = runTreeseedIntegratedDevReset(plan.reset, options, {
     write,
@@ -1258,7 +1490,7 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
     });
     return 1;
   }
-  writeCurrentDevRuntimeState(tenantRoot);
+  writeCurrentDevRuntimeState(tenantRoot, commandIds);
   const children = /* @__PURE__ */ new Map();
   const commandsById = new Map(plan.commands.map((command) => [command.id, command]));
   const requiredSurfaceIds = new Set(plan.readyChecks.filter((check) => check.required).map((check) => check.id));
@@ -1311,7 +1543,7 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
       for (const dispose of disposers) {
         dispose();
       }
-      removeCurrentDevRuntimeState(tenantRoot);
+      removeCurrentDevRuntimeState(tenantRoot, commandIds);
       emitEvent(
         options,
         write,

package/dist/layouts/AuthoredEntryLayout.astro

@@ -9,16 +9,53 @@ type LocalContributor = {
 	};
 };
 
+type MetadataItem = {
+	label: string;
+	value?: unknown;
+	href?: string;
+};
+
 function entryTitle(entry: RuntimeReferenceEntry) {
 	return entry.data.title ?? entry.data.name ?? entry.id;
 }
 
+function displayValue(value: unknown) {
+	if (value instanceof Date) return value.toISOString().slice(0, 10);
+	if (Array.isArray(value)) return value.map((entry) => displayValue(entry)).filter(Boolean).join(', ');
+	if (typeof value === 'string') return value.trim();
+	if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+	return '';
+}
+
+function metadataItem(label: string, value: unknown, href?: string): MetadataItem | null {
+	const display = displayValue(value);
+	return display ? { label, value: display, href } : null;
+}
+
+function metadataKey(item: MetadataItem) {
+	return `${item.label.toLowerCase()}::${displayValue(item.value).toLowerCase()}::${item.href ?? ''}`;
+}
+
+function uniqueMetadata(items: MetadataItem[]) {
+	const seen = new Set<string>();
+	return items.filter((item) => {
+		const key = metadataKey(item);
+		if (seen.has(key)) return false;
+		seen.add(key);
+		return true;
+	});
+}
+
 const {
 	entry,
 	currentPath,
 	contributor,
+	contentTypeLabel = 'Content',
+	contentId,
+	collectionLabel,
 	metaLabel,
 	metaValue,
+	metadataItems = [],
 	relatedQuestions = [],
 	relatedObjectives = [],
 	relatedNotes = [],
@@ -35,11 +72,17 @@ const {
 		date: Date;
 		motivation?: string;
 		tags: string[];
+		canonicalRoute?: string;
+		author?: string;
 	};
 	currentPath: string;
 	contributor: LocalContributor | RuntimeReferenceEntry | undefined | null;
+	contentTypeLabel?: string;
+	contentId?: string;
+	collectionLabel?: string;
 	metaLabel?: string;
 	metaValue?: string;
+	metadataItems?: MetadataItem[];
 	relatedQuestions?: RuntimeReferenceEntry[];
 	relatedObjectives?: RuntimeReferenceEntry[];
 	relatedNotes?: RuntimeReferenceEntry[];
@@ -48,88 +91,105 @@ const {
 	relatedBooks?: RuntimeReferenceEntry[];
 	introText?: string;
 };
+
+const contributorName = contributor?.data.name ?? entry.author ?? '';
+const normalizedTypeLabel = contentTypeLabel.trim() || 'Content';
+const contentKind = displayValue(metaValue);
+const recordMetadata = uniqueMetadata([
+	metadataItem('ID', contentId),
+	metadataItem('Collection', collectionLabel ?? (currentPath.replaceAll('/', '') || undefined)),
+	metadataItem(metaLabel ?? '', metaValue),
+	metadataItem('Route', entry.canonicalRoute, entry.canonicalRoute),
+	...metadataItems.map((item) => metadataItem(item.label, item.value, item.href)).filter(Boolean),
+].filter(Boolean) as MetadataItem[]);
+
+const relationSections = [
+	{ label: 'Questions', hrefBase: '/questions', items: relatedQuestions },
+	{ label: 'Objectives', hrefBase: '/objectives', items: relatedObjectives },
+	{ label: 'Notes', hrefBase: '/notes', items: relatedNotes },
+	{ label: 'Proposals', hrefBase: '/proposals', items: relatedProposals },
+	{ label: 'Decisions', hrefBase: '/decisions', items: relatedDecisions },
+	{ label: 'Books', hrefBase: '/books', items: relatedBooks },
+].filter((section) => section.items.length > 0);
+
+const relationCount = relationSections.reduce((total, section) => total + section.items.length, 0);
+const plainIntroText = displayValue(introText ?? entry.motivation);
 ---
 
 <MainLayout title={entry.title} description={entry.description} currentPath={currentPath}>
-	<article class="max-w-4xl space-y-8">
-		<div class="space-y-4 border-b border-[color:var(--ts-color-border)] pb-8">
-			<div class="flex flex-wrap items-center gap-3">
-				<StatusBadge status={entry.status} />
-				<p class="text-sm font-medium text-[color:var(--ts-color-text-subtle)]">{entry.date.toISOString().slice(0, 10)}</p>
-				{contributor && <p class="text-sm text-[color:var(--ts-color-text-subtle)]">{contributor.data.name}</p>}
-				{metaLabel && metaValue && <p class="text-sm text-[color:var(--ts-color-text-subtle)]">{metaLabel}: {metaValue}</p>}
+	<article class="max-w-6xl space-y-8">
+		<header class="grid gap-6 border-b border-[color:var(--ts-color-border)] pb-7 lg:grid-cols-[minmax(0,1fr)_18rem]">
+			<div class="space-y-4">
+				<div class="flex flex-wrap items-center gap-2.5">
+					<p class="rounded-full border border-[color:var(--ts-color-border)] px-3 py-1 text-xs font-semibold uppercase text-[color:var(--ts-color-info-text)]">{normalizedTypeLabel}</p>
+					{contentKind && <p class="rounded-full bg-[color:var(--ts-color-surface-muted)] px-3 py-1 text-xs font-semibold uppercase text-[color:var(--ts-color-text-subtle)]">{contentKind}</p>}
+					<StatusBadge status={entry.status} />
+					<p class="text-sm font-medium text-[color:var(--ts-color-text-subtle)]">{entry.date.toISOString().slice(0, 10)}</p>
+					{contributorName && <p class="text-sm text-[color:var(--ts-color-text-subtle)]">{contributorName}</p>}
+				</div>
+				<h1 class="max-w-4xl font-serif text-4xl font-bold tracking-normal text-[color:var(--ts-color-text)] md:text-5xl">{entry.title}</h1>
+				<p class="max-w-3xl text-lg leading-8 text-[color:var(--ts-color-text-muted)] md:text-xl md:leading-9">{entry.summary}</p>
+				{plainIntroText && (
+					<div class="max-w-3xl border-l-2 border-[color:var(--ts-color-border-strong)] pl-4">
+						<p class="text-xs font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Why it matters</p>
+						<p class="mt-1 text-sm leading-7 text-[color:var(--ts-color-text-muted)]">{plainIntroText}</p>
+					</div>
+				)}
+				{entry.tags.length > 0 && (
+					<ul class="flex flex-wrap gap-2" aria-label="Tags">
+						{entry.tags.map((tag) => (
+							<li class="rounded-full bg-[color:var(--ts-color-surface-muted)] px-3 py-1 text-xs font-semibold uppercase text-[color:var(--ts-color-accent-strong)]">{tag}</li>
+						))}
+					</ul>
+				)}
 			</div>
-			<h1 class="max-w-4xl font-serif text-5xl font-bold tracking-tight text-[color:var(--ts-color-text)] md:text-6xl">{entry.title}</h1>
-			<p class="max-w-3xl text-xl leading-10 text-[color:var(--ts-color-text-muted)]">{entry.summary}</p>
-			{(introText ?? entry.motivation) && <p class="max-w-3xl text-base leading-8 text-[color:var(--ts-color-text-muted)]">{introText ?? entry.motivation}</p>}
-			{entry.tags.length > 0 && (
-				<p class="text-sm uppercase tracking-[0.14em] text-[color:var(--ts-color-accent-strong)]">{entry.tags.join(' / ')}</p>
-			)}
-		</div>
-		<div class="prose-karyon">
+			<aside class="self-start border-l border-[color:var(--ts-color-border)] pl-5">
+				<div class="flex items-center justify-between gap-3 border-b border-[color:var(--ts-color-border)] pb-3">
+					<div>
+						<p class="text-xs font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Record</p>
+						<p class="mt-1 text-sm text-[color:var(--ts-color-text-muted)]">{relationCount} linked record{relationCount === 1 ? '' : 's'}</p>
+					</div>
+				</div>
+				<dl class="mt-2 text-sm">
+					{recordMetadata.map((item) => (
+						<div class="grid grid-cols-[5.75rem_minmax(0,1fr)] gap-3 py-2.5">
+							<dt class="text-[color:var(--ts-color-text-subtle)]">{item.label}</dt>
+							<dd class="min-w-0 break-words font-medium text-[color:var(--ts-color-text)]">
+								{item.href ? <a class="underline decoration-[color:var(--ts-color-border-strong)] underline-offset-4 hover:text-[color:var(--ts-color-accent-strong)]" href={item.href}>{displayValue(item.value)}</a> : displayValue(item.value)}
+							</dd>
+						</div>
+					))}
+				</dl>
+			</aside>
+		</header>
+		<div class="prose-karyon max-w-3xl">
 			<slot />
 		</div>
-		<div class="grid gap-6 border-t border-[color:var(--ts-color-border)] pt-8 md:grid-cols-3">
-			{relatedQuestions.length > 0 && (
-				<div>
-						<p class="text-sm font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Related questions</p>
-						<ul class="mt-3 space-y-2 text-[color:var(--ts-color-text-muted)]">
-							{relatedQuestions.map((question) => (
-								<li><a href={`/questions/${question.id}/`} class="hover:text-[color:var(--ts-color-text)]">{entryTitle(question)}</a></li>
-							))}
-						</ul>
-					</div>
-			)}
-			{relatedObjectives.length > 0 && (
-				<div>
-						<p class="text-sm font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Related objectives</p>
-						<ul class="mt-3 space-y-2 text-[color:var(--ts-color-text-muted)]">
-							{relatedObjectives.map((objective) => (
-								<li><a href={`/objectives/${objective.id}/`} class="hover:text-[color:var(--ts-color-text)]">{entryTitle(objective)}</a></li>
-							))}
-						</ul>
+		{relationSections.length > 0 && (
+			<section class="border-t border-[color:var(--ts-color-border)] pt-7">
+				<div class="mb-4 flex flex-wrap items-end justify-between gap-3">
+					<div>
+						<p class="text-xs font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Connections</p>
 					</div>
-			)}
-			{relatedNotes.length > 0 && (
-				<div>
-						<p class="text-sm font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Related notes</p>
-						<ul class="mt-3 space-y-2 text-[color:var(--ts-color-text-muted)]">
-							{relatedNotes.map((note) => (
-								<li><a href={`/notes/${note.id}/`} class="hover:text-[color:var(--ts-color-text)]">{entryTitle(note)}</a></li>
-							))}
-						</ul>
-					</div>
-			)}
-			{relatedProposals.length > 0 && (
-				<div>
-						<p class="text-sm font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Related proposals</p>
-						<ul class="mt-3 space-y-2 text-[color:var(--ts-color-text-muted)]">
-							{relatedProposals.map((proposal) => (
-								<li><a href={`/proposals/${proposal.id}/`} class="hover:text-[color:var(--ts-color-text)]">{entryTitle(proposal)}</a></li>
-							))}
-						</ul>
-					</div>
-			)}
-			{relatedDecisions.length > 0 && (
-				<div>
-						<p class="text-sm font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Related decisions</p>
-						<ul class="mt-3 space-y-2 text-[color:var(--ts-color-text-muted)]">
-							{relatedDecisions.map((decision) => (
-								<li><a href={`/decisions/${decision.id}/`} class="hover:text-[color:var(--ts-color-text)]">{entryTitle(decision)}</a></li>
-							))}
-						</ul>
-					</div>
-			)}
-			{relatedBooks.length > 0 && (
-				<div>
-						<p class="text-sm font-semibold uppercase tracking-[0.14em] text-[color:var(--ts-color-info-text)]">Related books</p>
-						<ul class="mt-3 space-y-2 text-[color:var(--ts-color-text-muted)]">
-							{relatedBooks.map((book) => (
-								<li><a href={`/books/${book.id}/`} class="hover:text-[color:var(--ts-color-text)]">{entryTitle(book)}</a></li>
-							))}
-						</ul>
-					</div>
-			)}
-		</div>
+				</div>
+				<div class="grid gap-4 md:grid-cols-2 xl:grid-cols-3">
+					{relationSections.map((section) => (
+						<div class="border-l border-[color:var(--ts-color-border)] pl-4">
+							<p class="text-xs font-semibold uppercase tracking-[0.12em] text-[color:var(--ts-color-text-subtle)]">{section.label}</p>
+							<ul class="mt-2 space-y-2">
+								{section.items.map((item) => (
+									<li>
+										<a href={`${section.hrefBase}/${item.id}/`} class="block text-[color:var(--ts-color-text)] hover:text-[color:var(--ts-color-accent-strong)]">
+											<span class="block text-sm font-semibold">{entryTitle(item)}</span>
+											<span class="block text-xs text-[color:var(--ts-color-text-subtle)]">{item.id}</span>
+										</a>
+									</li>
+								))}
+							</ul>
+						</div>
+					))}
+				</div>
+			</section>
+		)}
 	</article>
 </MainLayout>

package/dist/layouts/MainLayout.astro

@@ -1,6 +1,7 @@
 ---
 import '../styles/global.css';
 import PublicShell from '../components/ui/shell/PublicShell.astro';
+import ShellIconLink from '../components/ui/shell/ShellIconLink.astro';
 import { SITE_NAV_GROUPS } from '../utils/routes';
 import { SITE } from '../utils/seo';
 import { SITE_THEME_CSS } from '../utils/site-config';
@@ -36,6 +37,7 @@ const navItems = SITE_NAV_GROUPS.flatMap((group) => group.items);
 		{SITE_THEME_CSS && <style is:global>{SITE_THEME_CSS}</style>}
 	</Fragment>
 	<Fragment slot="actions">
+		<ShellIconLink href="/app/" label="Manager" icon="manager" />
 		<a
 			href={SITE.githubRepository}
 			target="_blank"

package/dist/pages/decisions/[slug].astro

@@ -57,9 +57,17 @@ const supersededDecisions = publishedRuntime
 			entry={decision.data}
 			currentPath="/decisions/"
 			contributor={contributor}
+			contentTypeLabel="Decision"
+			contentId={decision.id}
+			collectionLabel="decisions"
 			metaLabel="Decision type"
 			metaValue={String(decision.data.decisionType ?? '')}
-			introText={`${decision.data.rationale ?? ''} Authority: ${decision.data.authority ?? ''}.`}
+			introText={decision.data.rationale}
+			metadataItems={[
+				{ label: 'Authority', value: decision.data.authority },
+				{ label: 'Route', value: decision.data.canonicalRoute, href: decision.data.canonicalRoute },
+				{ label: 'Implements', value: decision.data.implements },
+			]}
 			relatedObjectives={relatedObjectives}
 			relatedQuestions={relatedQuestions}
 			relatedNotes={relatedNotes}

package/dist/pages/notes/[slug].astro

@@ -1,9 +1,9 @@
 ---
 import { getCollection, render } from 'astro:content';
-import NoteLayout from '../../layouts/NoteLayout.astro';
+import AuthoredEntryLayout from '../../layouts/AuthoredEntryLayout.astro';
 import PublishedContentBody from '../../components/site/PublishedContentBody.astro';
 import RouteNotFound from '../../components/site/RouteNotFound.astro';
-import { isPublishedRuntimeContentMode, loadPublishedEntry } from '../../utils/site-content-runtime';
+import { isPublishedRuntimeContentMode, loadPublishedEntry, metadataFromPublishedContent } from '../../utils/site-content-runtime';
 
 export const prerender = false;
 
@@ -13,6 +13,7 @@ const notes = publishedRuntime ? [] : await getCollection('notes', ({ data }) =>
 const localNote = publishedRuntime ? null : notes.find((candidate) => candidate.id === slug) ?? null;
 const publishedNote = publishedRuntime ? await loadPublishedEntry(Astro.locals, 'notes', slug) : null;
 const note = publishedRuntime ? publishedNote?.entry ?? null : localNote;
+const metadata = publishedRuntime ? metadataFromPublishedContent(publishedNote?.content) : null;
 if (!note) {
 	Astro.response.status = 404;
 }
@@ -24,8 +25,20 @@ const Content = rendered?.Content ?? null;
 	!note || (!Content && !publishedNote?.html) ? (
 		<RouteNotFound title="Note not found" description="The requested note could not be found in this Treeseed." currentPath="/notes/" />
 	) : (
-		<NoteLayout note={note.data}>
+		<AuthoredEntryLayout
+			entry={note.data}
+			currentPath="/notes/"
+			contributor={null}
+			contentTypeLabel="Note"
+			contentId={note.id}
+			collectionLabel="notes"
+			metaLabel="Author"
+			metaValue={String(note.data.author ?? metadata?.author ?? '')}
+			metadataItems={[
+				{ label: 'Route', value: note.data.canonicalRoute ?? metadata?.canonicalRoute, href: note.data.canonicalRoute ?? metadata?.canonicalRoute },
+			]}
+		>
 			{publishedRuntime ? <PublishedContentBody html={publishedNote?.html ?? ''} /> : <Content />}
-		</NoteLayout>
+		</AuthoredEntryLayout>
 	)
 }

package/dist/pages/objectives/[slug].astro

@@ -45,8 +45,12 @@ const relatedBooks = publishedRuntime
 			entry={objective.data}
 			currentPath="/objectives/"
 			contributor={contributor}
+			contentTypeLabel="Objective"
+			contentId={objective.id}
+			collectionLabel="objectives"
 			metaLabel="Time horizon"
 			metaValue={String(objective.data.timeHorizon ?? '')}
+			metadataItems={[]}
 			relatedQuestions={relatedQuestions}
 			relatedBooks={relatedBooks}
 		>

package/dist/pages/proposals/[slug].astro

@@ -57,8 +57,14 @@ const supersededProposals = publishedRuntime
 			entry={proposal.data}
 			currentPath="/proposals/"
 			contributor={contributor}
+			contentTypeLabel="Proposal"
+			contentId={proposal.id}
+			collectionLabel="proposals"
 			metaLabel="Proposal type"
 			metaValue={String(proposal.data.proposalType ?? '')}
+			metadataItems={[
+				{ label: 'Route', value: proposal.data.canonicalRoute, href: proposal.data.canonicalRoute },
+			]}
 			relatedObjectives={relatedObjectives}
 			relatedQuestions={relatedQuestions}
 			relatedNotes={relatedNotes}

package/dist/pages/questions/[slug].astro

@@ -45,8 +45,12 @@ const relatedBooks = publishedRuntime
 			entry={question.data}
 			currentPath="/questions/"
 			contributor={contributor}
+			contentTypeLabel="Question"
+			contentId={question.id}
+			collectionLabel="questions"
 			metaLabel="Question type"
 			metaValue={String(question.data.questionType ?? '')}
+			metadataItems={[]}
 			relatedObjectives={relatedObjectives}
 			relatedBooks={relatedBooks}
 		>

package/dist/scripts/build-dist.js

@@ -391,7 +391,7 @@ async function main() {
     writeCompatibilityEntrypoint(resolve(distRoot, 'config.d.ts'), "export declare function createTreeseedTenantSite(manifestPath?: string): import('astro').AstroUserConfig<never, never, never>;");
     writeCompatibilityEntrypoint(resolve(distRoot, 'content.d.ts'), "export declare function createTreeseedCollections(tenantConfig: any, dependencies: any): Record<string, any>;");
     writeCompatibilityEntrypoint(resolve(distRoot, 'content-config.js'), "import { loadTreeseedManifest } from '@treeseed/sdk/platform/tenant-config';\nimport { docsLoader } from './vendor/starlight/loaders.js';\nimport { docsSchema } from './vendor/starlight/schema.js';\nimport { createTreeseedCollections } from './content.js';\n\nexport function createTreeseedTenantCollections(manifestPath) {\n\tconst tenant = loadTreeseedManifest(manifestPath);\n\treturn createTreeseedCollections(tenant, { docsLoader, docsSchema });\n}");
-    writeCompatibilityEntrypoint(resolve(distRoot, 'content-config.d.ts'), "export declare function createTreeseedTenantCollections(manifestPath?: string): {\n\tpages: any;\n\tnotes: any;\n\tquestions: any;\n\tobjectives: any;\n\tpeople: any;\n\tagents: any;\n\tbooks: any;\n\tdocs: any;\n\tworkdays?: any;\n};");
+    writeCompatibilityEntrypoint(resolve(distRoot, 'content-config.d.ts'), "export declare function createTreeseedTenantCollections(manifestPath?: string): {\n\tpages: any;\n\tnotes: any;\n\tquestions: any;\n\tobjectives: any;\n\tpeople: any;\n\tagents: any;\n\tagent_tests?: any;\n\tbooks: any;\n\tdocs: any;\n\tworkdays?: any;\n};");
     writeCompatibilityEntrypoint(resolve(distRoot, 'utils/forms/service.d.ts'), "import type { APIContext } from 'astro';\nimport type { SubmitResult } from '../../types/forms.js';\nexport declare function handleTokenRequest(context: APIContext): Promise<Response>;\nexport declare function handleFormSubmission(context: APIContext): Promise<SubmitResult>;");
     rmSync(resolve(distRoot, 'config.d.js'), { force: true });
     rmSync(resolve(distRoot, 'content-config.d.js'), { force: true });

package/dist/scripts/dev-platform.js

@@ -50,6 +50,26 @@ function parseOpenMode(value) {
     }
     return undefined;
 }
+function parseLocalRuntimeMode(value) {
+    if (value === 'auto' || value === 'provider' || value === 'local') {
+        return value;
+    }
+    return undefined;
+}
+function readForwardedEnvironment() {
+    const keys = [
+        'TREESEED_DOCS_AUTOMATION_MODE',
+        'TREESEED_WORKDAY_ID',
+        'TREESEED_CAPACITY_BUDGET',
+        'TREESEED_WORKDAY_TASK_CREDIT_BUDGET',
+        'TREESEED_APPROVAL_POLICY',
+        'TREESEED_MANAGER_CONSOLE_SUMMARY',
+        'TREESEED_WORKER_CONSOLE_SUMMARY',
+    ];
+    return Object.fromEntries(keys
+        .map((key) => [key, process.env[key]])
+        .filter((entry) => typeof entry[1] === 'string' && entry[1].length > 0));
+}
 const exitCode = await runTreeseedIntegratedDev({
     surface: parseSurface(readOption('--surface')),
     surfaces: readOption('--surfaces'),
@@ -58,13 +78,16 @@ const exitCode = await runTreeseedIntegratedDev({
     webPort: readNumberOption('--port'),
     apiHost: readOption('--api-host'),
     apiPort: readNumberOption('--api-port'),
+    webRuntime: parseLocalRuntimeMode(readOption('--web-runtime')),
     setupMode: parseSetupMode(readOption('--setup')),
     feedbackMode: parseFeedbackMode(readOption('--feedback')),
     openMode: parseOpenMode(readOption('--open')),
     plan: readFlag('--plan'),
     reset: readFlag('--reset'),
+    force: readFlag('--force'),
     json: readFlag('--json'),
     projectId: readOption('--project-id'),
     teamId: readOption('--team-id'),
+    env: readForwardedEnvironment(),
 });
 process.exit(exitCode);

package/dist/site.js

@@ -313,6 +313,9 @@ function createTreeseedSite(tenantConfig, { starlight }) {
         __TREESEED_DEPLOY_CONFIG__: injectedDeployConfig,
         __TREESEED_BOOK_RUNTIME__: injectedBookRuntime
       },
+      optimizeDeps: {
+        exclude: ["libsodium-wrappers-sumo"]
+      },
       plugins: [
         createTenantThemeVitePlugin(tenantThemeCss),
         tailwindcss(),

package/dist/styles/app-shell.css

@@ -27,15 +27,25 @@
 	align-self: start;
 	background: var(--ts-color-canvas-subtle);
 	border-right: 1px solid var(--ts-color-border);
+	box-sizing: border-box;
 	display: grid;
 	gap: var(--ts-space-3);
+	grid-template-rows: minmax(0, 1fr) auto;
 	height: 100vh;
-	overflow: auto;
+	overflow: hidden;
 	padding: var(--ts-space-3);
 	position: sticky;
 	top: 0;
 }
 
+.ts-app-shell__rail-scroll {
+	display: grid;
+	gap: var(--ts-space-3);
+	min-height: 0;
+	overflow: auto;
+	padding-right: 0.15rem;
+}
+
 .ts-shell-brand {
 	align-items: center;
 	color: var(--ts-color-text);
@@ -109,6 +119,12 @@
 	min-width: 0;
 }
 
+.ts-shell-utility-actions {
+	align-items: center;
+	display: inline-flex;
+	gap: var(--ts-space-1);
+}
+
 .ts-app-shell__rail-context,
 .ts-app-shell__quick-actions {
 	border-top: 1px solid var(--ts-color-border);
@@ -117,6 +133,11 @@
 	padding-top: var(--ts-space-2);
 }
 
+.ts-app-shell__quick-actions {
+	background: var(--ts-color-canvas-subtle);
+	padding-bottom: 0.1rem;
+}
+
 .ts-app-shell__eyebrow {
 	color: var(--ts-color-text-subtle);
 	font-size: 0.75rem;
@@ -568,6 +589,10 @@
 		width: 100%;
 	}
 
+	.ts-app-shell__header-actions .ts-shell-utility-actions {
+		display: none;
+	}
+
 	.ts-bottom-nav {
 		display: grid;
 	}

package/dist/styles/theme.css

@@ -20,13 +20,13 @@ body {
 
 .ts-theme-menu__trigger {
 	align-items: center;
-	background: var(--ts-color-surface);
-	border: 1px solid var(--ts-color-border);
+	background: transparent;
+	border: 1px solid transparent;
 	border-radius: var(--ts-radius-md);
 	color: var(--ts-color-text-muted);
 	cursor: pointer;
 	display: inline-flex;
-	height: 2rem;
+	height: 2.25rem;
 	justify-content: center;
 	list-style: none;
 	padding: 0;
@@ -34,7 +34,7 @@ body {
 		background-color 140ms ease,
 		border-color 140ms ease,
 		color 140ms ease;
-	width: 2rem;
+	width: 2.25rem;
 }
 
 .ts-theme-menu__trigger::-webkit-details-marker {
@@ -43,8 +43,8 @@ body {
 
 .ts-theme-menu__trigger:hover,
 .ts-theme-menu[open] .ts-theme-menu__trigger {
-	background: var(--ts-color-surface-muted);
-	border-color: var(--ts-color-border-strong);
+	background: var(--ts-color-surface-raised);
+	border-color: var(--ts-color-border);
 	color: var(--ts-color-text);
 }
 
@@ -56,8 +56,8 @@ body {
 .ts-theme-menu__trigger svg {
 	display: block;
 	fill: currentColor;
-	height: 1rem;
-	width: 1rem;
+	height: 1.15rem;
+	width: 1.15rem;
 }
 
 .ts-theme-menu__panel {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/core",
-  "version": "0.8.19",
+  "version": "0.9.0",
   "description": "Treeseed web framework package for Astro/Starlight site runtimes.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -70,7 +70,7 @@
     "@astrojs/sitemap": "3.7.0",
     "@astrojs/starlight": "0.37.6",
     "@tailwindcss/vite": "^4.1.4",
-    "@treeseed/sdk": "0.8.19",
+    "@treeseed/sdk": "0.9.0",
     "astro": "^5.6.1",
     "esbuild": "^0.28.0",
     "katex": "^0.16.22",