@tera-system/core 0.1.0

package/core/tera-system/teranoo-ui/components/sidebar.tsx

@@ -0,0 +1,66 @@
+import * as React from "react"
+
+interface SidebarItem {
+  label: string
+  icon?: React.ReactNode
+  href?: string
+  active?: boolean
+  children?: SidebarItem[]
+}
+
+interface SidebarProps {
+  items: SidebarItem[]
+  collapsed?: boolean
+  onToggle?: () => void
+  footer?: React.ReactNode
+}
+
+export function Sidebar({ items, collapsed, onToggle, footer }: SidebarProps) {
+  return (
+    <aside
+      className={`flex flex-col border-l border-[var(--teranoo-border)] bg-[var(--teranoo-background)] transition-all duration-300 ${
+        collapsed ? "w-16" : "w-64"
+      }`}
+    >
+      <div className="flex items-center justify-between p-4 border-b border-[var(--teranoo-border)]">
+        {!collapsed && (
+          <span className="font-semibold text-lg">Teranoo</span>
+        )}
+        <button
+          onClick={onToggle}
+          className="p-1 rounded-md hover:bg-[var(--teranoo-muted)]"
+        >
+          {collapsed ? "→" : "←"}
+        </button>
+      </div>
+
+      <nav className="flex-1 p-2 space-y-1">
+        {items.map((item, i) => (
+          <SidebarLink key={i} item={item} collapsed={collapsed} />
+        ))}
+      </nav>
+
+      {footer && (
+        <div className="p-4 border-t border-[var(--teranoo-border)]">
+          {footer}
+        </div>
+      )}
+    </aside>
+  )
+}
+
+function SidebarLink({ item, collapsed }: { item: SidebarItem; collapsed?: boolean }) {
+  return (
+    <a
+      href={item.href || "#"}
+      className={`flex items-center gap-3 px-3 py-2 rounded-[var(--teranoo-radius)] text-sm transition-colors ${
+        item.active
+          ? "bg-[var(--teranoo-primary)] text-[var(--teranoo-primary-foreground)]"
+          : "text-[var(--teranoo-foreground)] hover:bg-[var(--teranoo-muted)]"
+      }`}
+    >
+      {item.icon && <span className="h-4 w-4">{item.icon}</span>}
+      {!collapsed && <span>{item.label}</span>}
+    </a>
+  )
+}

package/core/tera-system/teranoo-ui/components/stats-card.tsx

@@ -0,0 +1,37 @@
+import * as React from "react"
+import { Card, CardContent } from "./card"
+
+interface StatsCardProps {
+  label: string
+  value: string | number
+  description?: string
+  trend?: "up" | "down" | "neutral"
+}
+
+export function StatsCard({ label, value, description, trend }: StatsCardProps) {
+  const trendIcon = trend === "up" ? "↑" : trend === "down" ? "↓" : "→"
+  const trendColor = trend === "up"
+    ? "text-[var(--teranoo-success)]"
+    : trend === "down"
+    ? "text-[var(--teranoo-danger)]"
+    : "text-[var(--teranoo-muted-foreground)]"
+
+  return (
+    <Card>
+      <CardContent className="p-4">
+        <div className="space-y-1">
+          <p className="text-xs text-[var(--teranoo-muted-foreground)]">{label}</p>
+          <div className="flex items-baseline gap-2">
+            <p className="text-2xl font-bold">{value}</p>
+            {trend && (
+              <span className={`text-sm ${trendColor}`}>{trendIcon}</span>
+            )}
+          </div>
+          {description && (
+            <p className="text-xs text-[var(--teranoo-muted-foreground)]">{description}</p>
+          )}
+        </div>
+      </CardContent>
+    </Card>
+  )
+}

package/core/tera-system/teranoo-ui/registry.json

@@ -0,0 +1,77 @@
+{
+  "name": "teranoo-ui",
+  "description": "Teranoo UI Registry — مكونات Tera المعتمدة لتطبيقات الزبائن",
+  "version": "1.0.0",
+  "registry": [
+    {
+      "name": "button",
+      "type": "components:ui",
+      "description": "زر Tera الأساسي — يمتد shadcn button مع ثيم Tera",
+      "dependencies": ["@radix-ui/react-slot"],
+      "files": ["components/button.tsx"]
+    },
+    {
+      "name": "card",
+      "type": "components:ui",
+      "description": "بطاقة Tera — تعرض محتوى بحدود وظل موحدين",
+      "dependencies": [],
+      "files": ["components/card.tsx"]
+    },
+    {
+      "name": "dashboard-layout",
+      "type": "components:ui",
+      "description": "هيكل لوحة تحكم كامل — Sidebar + Header + Main",
+      "dependencies": [],
+      "files": ["components/dashboard-layout.tsx"]
+    },
+    {
+      "name": "data-table",
+      "type": "components:ui",
+      "description": "جدول بيانات متقدم — فرز، فلتر، بحث، Pagination",
+      "dependencies": ["@tanstack/react-table"],
+      "files": ["components/data-table.tsx"]
+    },
+    {
+      "name": "kpi-card",
+      "type": "components:ui",
+      "description": "بطاقة KPI — عنوان، قيمة، مؤشر تغيير، أيقونة",
+      "dependencies": [],
+      "files": ["components/kpi-card.tsx"]
+    },
+    {
+      "name": "sidebar",
+      "type": "components:ui",
+      "description": "قائمة جانبية — عناصر قائمة مع أيقونات، قابلة للطي",
+      "dependencies": ["@radix-ui/react-dialog"],
+      "files": ["components/sidebar.tsx"]
+    },
+    {
+      "name": "stats-card",
+      "type": "components:ui",
+      "description": "بطاقة إحصائية — رقم، وصف، رسم بياني صغير",
+      "dependencies": [],
+      "files": ["components/stats-card.tsx"]
+    },
+    {
+      "name": "page-header",
+      "type": "components:ui",
+      "description": "عنوان صفحة موحّد — عنوان، وصف، أزرار إجراءات",
+      "dependencies": [],
+      "files": ["components/page-header.tsx"]
+    },
+    {
+      "name": "search-input",
+      "type": "components:ui",
+      "description": "حقل بحث موحّد — أيقونة، كتابة، مسح",
+      "dependencies": [],
+      "files": ["components/search-input.tsx"]
+    },
+    {
+      "name": "empty-state",
+      "type": "components:ui",
+      "description": "حالة عدم وجود بيانات — أيقونة، رسالة، زر إجراء",
+      "dependencies": [],
+      "files": ["components/empty-state.tsx"]
+    }
+  ]
+}

package/core/tera-system/teranoo-ui/styles/teranoo-theme.css

@@ -0,0 +1,61 @@
+/* ============================================
+   Teranoo Theme — ألوان Tera الموحّدة
+   استخدم هذا الملف في أي مشروع Tera UI
+   ============================================ */
+
+:root {
+  /* الألوان الأساسية */
+  --teranoo-primary: #2563eb;
+  --teranoo-primary-foreground: #ffffff;
+  --teranoo-primary-hover: #1d4ed8;
+
+  --teranoo-secondary: #64748b;
+  --teranoo-secondary-foreground: #ffffff;
+
+  --teranoo-accent: #f59e0b;
+  --teranoo-accent-foreground: #1c1917;
+
+  --teranoo-success: #10b981;
+  --teranoo-warning: #f59e0b;
+  --teranoo-danger: #ef4444;
+  --teranoo-info: #3b82f6;
+
+  /* الخلفية والنص */
+  --teranoo-background: #ffffff;
+  --teranoo-foreground: #0f172a;
+  --teranoo-muted: #f1f5f9;
+  --teranoo-muted-foreground: #64748b;
+  --teranoo-border: #e2e8f0;
+  --teranoo-input: #e2e8f0;
+  --teranoo-ring: #2563eb;
+
+  /* الزوايا */
+  --teranoo-radius: 0.5rem;
+
+  /* الخطوط */
+  --teranoo-font-family: 'Cairo', 'Inter', sans-serif;
+  --teranoo-font-size-xs: 0.75rem;
+  --teranoo-font-size-sm: 0.875rem;
+  --teranoo-font-size-base: 1rem;
+  --teranoo-font-size-lg: 1.125rem;
+  --teranoo-font-size-xl: 1.25rem;
+  --teranoo-font-size-2xl: 1.5rem;
+
+  /* الظلال */
+  --teranoo-shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
+  --teranoo-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
+  --teranoo-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
+  --teranoo-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+
+  /* RTL */
+  --teranoo-direction: rtl;
+}
+
+/* وضع الظلام (اختياري) */
+.dark {
+  --teranoo-primary: #3b82f6;
+  --teranoo-background: #0f172a;
+  --teranoo-foreground: #f8fafc;
+  --teranoo-muted: #1e293b;
+  --teranoo-border: #334155;
+}

package/opencode.tera.example.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "playwright": {
+      "type": "local",
+      "command": ["npx", "-y", "@playwright/mcp"],
+      "enabled": true
+    },
+    "semgrep": {
+      "type": "local",
+      "command": ["npx", "-y", "mcp-server-semgrep"],
+      "enabled": true
+    },
+    "structurizr": {
+      "type": "local",
+      "command": [
+        "uv",
+        "run",
+        "--directory",
+        "structurizr-mcp",
+        "structurizr-mcp"
+      ],
+      "enabled": false,
+      "env": {
+        "STRUCTURIZR_WORKSPACE_DIR": "../architecture",
+        "STRUCTURIZR_URL": "http://localhost:8081"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@tera-system/core",
+  "version": "0.1.0",
+  "description": "Tera System OpenCode Plugin — governance core, 20 agents, 10 commands, distribution tools",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "agents",
+    "commands",
+    "core",
+    "tools",
+    "scripts",
+    "MANIFEST.json",
+    "opencode.tera.example.json",
+    "WELCOME.md",
+    "README.md",
+    "LICENSE.md",
+    "RELEASES.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "tera",
+    "governance",
+    "agents",
+    "component"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/build.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * @tera/core build script
+ * --------------------------------------------------------------
+ * Produces a repeatable, verifiable release artifact for the
+ * OpenCode addon. NON-DESTRUCTIVE: only (re)creates files under
+ * `artifacts/` and NEVER touches package source content.
+ *
+ * Steps:
+ *   1. Validate content counts against MANIFEST.json (self-check).
+ *   2. `npm pack` the current package -> artifacts/<name>-<version>.tgz
+ *   3. Compute per-content-group SHA256 + artifact SHA256.
+ *   4. Write artifacts/SHA256SUMS.txt (+ per-file group map).
+ *
+ * Usage:
+ *   node scripts/build.mjs            (default: version from package.json)
+ */
+import { execSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, "..");
+const ART = path.join(ROOT, "artifacts");
+
+const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, "package.json"), "utf8"));
+const manifest = JSON.parse(fs.readFileSync(path.join(ROOT, "MANIFEST.json"), "utf8"));
+
+const countFiles = (dir) =>
+  fs.existsSync(path.join(ROOT, dir))
+    ? (function walk(d) {
+        let n = 0;
+        for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+          if (e.isDirectory()) n += walk(path.join(d, e.name));
+          else if (e.isFile()) n++;
+        }
+        return n;
+      })(path.join(ROOT, dir))
+    : 0;
+
+const groupSha = (dir) => {
+  if (!fs.existsSync(path.join(ROOT, dir))) return null;
+  const lines = [];
+  (function walk(d) {
+    for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+      const full = path.join(d, e.name);
+      if (e.isDirectory()) walk(full);
+      else if (e.isFile()) {
+        const h = createHash("sha256").update(fs.readFileSync(full)).digest("hex");
+        lines.push(`${path.relative(ROOT, full).split(path.sep).join("/")}:${h}`);
+      }
+    }
+  })(path.join(ROOT, dir));
+  lines.sort();
+  return createHash("sha256").update(lines.join("\n")).digest("hex");
+};
+
+/* 1. self-check counts vs manifest */
+console.log("── self-check: content counts vs MANIFEST.json");
+const checks = [
+  ["agents", "agents"],
+  ["commands", "commands"],
+  ["core/tera-system", "coreFiles"],
+];
+let fail = false;
+for (const [dir, key] of checks) {
+  const n = countFiles(dir);
+  const expected = manifest.content[key];
+  const ok = n === expected;
+  console.log(`   ${dir.padEnd(16)} ${n} (manifest ${expected}) ${ok ? "OK" : "MISMATCH"}`);
+  if (!ok) fail = true;
+}
+if (fail) {
+  console.error("✖ Self-check failed — aborting build.");
+  process.exit(1);
+}
+
+/* 2. pack */
+console.log("── npm pack");
+fs.mkdirSync(ART, { recursive: true });
+const tarball = execSync(`npm pack ${JSON.stringify(ROOT)} --pack-destination ${JSON.stringify(ART)} --silent`, { cwd: ROOT, encoding: "utf8" }).trim();
+console.log(`   artifact: ${tarball}`);
+
+/* 3. hashes */
+const artPath = path.join(ART, tarball);
+const artHash = createHash("sha256").update(fs.readFileSync(artPath)).digest("hex");
+console.log(`   SHA256  : ${artHash}`);
+
+const groupHashes = {
+  agents: groupSha("agents"),
+  commands: groupSha("commands"),
+  "core/tera-system": groupSha("core/tera-system"),
+  tools: groupSha("tools"),
+  "core/project-control": groupSha("core/project-control"),
+};
+console.log("   group hashes:");
+for (const [g, h] of Object.entries(groupHashes)) console.log(`     ${g.padEnd(20)} ${h ?? "(n/a)"}`);
+
+/* 4. write SHA256SUMS + group map + sync MANIFEST.json (single source of truth) */
+fs.writeFileSync(path.join(ART, "SHA256SUMS.txt"), `${artHash}  ${tarball}\n`);
+fs.writeFileSync(path.join(ART, "GROUPS.json"), JSON.stringify({ version: pkg.version, builtAt: new Date().toISOString(), sha256: groupHashes }, null, 2));
+manifest.sha256 = groupHashes;
+manifest.version = pkg.version;
+manifest.builtAt = new Date().toISOString().slice(0, 10);
+fs.writeFileSync(path.join(ROOT, "MANIFEST.json"), JSON.stringify(manifest, null, 2) + "\n");
+console.log("   wrote SHA256SUMS.txt + GROUPS.json + synced MANIFEST.json");
+
+console.log("\n✔ build complete — artifact ready in artifacts/");

package/scripts/install.js

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+/**
+ * @tera/core installer
+ * --------------------------------------------------------------
+ * NON-DESTRUCTIVE + OWNERSHIP-AWARE installer for the Tera System
+ * OpenCode Plugin component.
+ *
+ * Rules:
+ *  - Never deletes anything.
+ *  - Never overwrites a file it does not own.
+ *  - Tracks ownership via `.opencode/tera-core.manifest.json`.
+ *  - Only updates files it owns, always keeping a backup first.
+ *  - Idempotent: re-running is safe; identical files are skipped.
+ *  - Never touches an existing user `opencode.json`.
+ *
+ * Target resolution (first match wins):
+ *   1. `--target <dir>` argument
+ *   2. `TERA_TARGET_DIR` environment variable
+ *   3. `INIT_CWD` (set by npm for lifecycle scripts)
+ *   4. current working directory
+ */
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { assessLicenseState, readLicenseState, writeLicenseState } from "./lib/license.mjs";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = path.resolve(__dirname, "..");
+const MANIFEST_NAME = "tera-core.manifest.json";
+const CONFIG_EXAMPLE = "opencode.tera.example.json";
+
+/* ---------------------------------- helpers ---------------------------------- */
+
+const sha256 = (buf) => createHash("sha256").update(buf).digest("hex");
+
+const toPosix = (p) => p.split(path.sep).join("/");
+
+function resolveTarget() {
+  const args = process.argv.slice(2);
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--help") {
+      console.log("Usage: node scripts/install.js [--target <workspaceRoot>]");
+      process.exit(0);
+    }
+    if (args[i] === "--target" && args[i + 1]) {
+      return path.resolve(args[i + 1]);
+    }
+  }
+  if (process.env.TERA_TARGET_DIR) return path.resolve(process.env.TERA_TARGET_DIR);
+  if (process.env.INIT_CWD) return path.resolve(process.env.INIT_CWD);
+  return path.resolve(process.cwd());
+}
+
+function walkFiles(dir) {
+  const out = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) out.push(...walkFiles(full));
+    else if (entry.isFile()) out.push(full);
+  }
+  return out;
+}
+
+function copyFile(src, dest) {
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+
+function loadOwnership(target) {
+  const p = path.join(target, ".opencode", MANIFEST_NAME);
+  if (!fs.existsSync(p)) return { files: {} };
+  try {
+    const parsed = JSON.parse(fs.readFileSync(p, "utf8"));
+    return { files: parsed.files && typeof parsed.files === "object" ? parsed.files : {} };
+  } catch {
+    return { files: {} };
+  }
+}
+
+/* ---------------------------------- state ---------------------------------- */
+
+const target = resolveTarget();
+const pkg = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, "package.json"), "utf8"));
+const ownership = loadOwnership(target);
+
+const stats = { installed: 0, updated: 0, identical: 0, skippedGroups: 0, conflicts: [] };
+
+/* ------------------------------- group install ------------------------------- */
+
+/**
+ * @param {{name:string, src:string, dest:string}} group
+ */
+function installGroup(group) {
+  if (!fs.existsSync(group.src)) return;
+  for (const srcFile of walkFiles(group.src)) {
+    const relSrc = path.relative(group.src, srcFile);
+    const destFile = path.join(group.dest, relSrc);
+    const destRel = toPosix(path.relative(target, destFile));
+    const srcHash = sha256(fs.readFileSync(srcFile));
+
+    if (fs.existsSync(destFile)) {
+      const destHash = sha256(fs.readFileSync(destFile));
+      if (destHash === srcHash) {
+        stats.identical++;
+        continue;
+      }
+      const owned = Object.prototype.hasOwnProperty.call(ownership.files, destRel);
+      if (owned) {
+        const bak = `${destFile}.tera-bak-${Date.now()}`;
+        fs.copyFileSync(destFile, bak);
+        fs.copyFileSync(srcFile, destFile);
+        ownership.files[destRel] = srcHash;
+        stats.updated++;
+        console.log(`  [updated ] ${destRel}  (backup: ${path.basename(bak)})`);
+      } else {
+        stats.conflicts.push(destRel);
+        console.log(`  [CONFLICT] ${destRel} — kept your file (unowned, not overwritten).`);
+      }
+    } else {
+      copyFile(srcFile, destFile);
+      ownership.files[destRel] = srcHash;
+      stats.installed++;
+      console.log(`  [install ] ${destRel}`);
+    }
+  }
+}
+
+/* ---------------------------------- config ---------------------------------- */
+
+function installConfig() {
+  const configSrc = path.join(PKG_ROOT, CONFIG_EXAMPLE);
+  if (!fs.existsSync(configSrc)) return;
+  const configDest = path.join(target, ".opencode", "opencode.json");
+  const configRel = ".opencode/opencode.json";
+
+  if (fs.existsSync(configDest)) {
+    const a = sha256(fs.readFileSync(configDest));
+    const b = sha256(fs.readFileSync(configSrc));
+    if (a === b) {
+      stats.identical++;
+      console.log(`  [same    ] ${configRel} — already identical.`);
+    } else {
+      stats.conflicts.push(configRel);
+      console.log(`  [CONFLICT] ${configRel} — kept yours. Reference copy provided below.`);
+    }
+  } else {
+    copyFile(configSrc, configDest);
+    ownership.files[configRel] = sha256(fs.readFileSync(configDest));
+    stats.installed++;
+    console.log(`  [install ] ${configRel}`);
+  }
+
+  // Additive reference copy — always written, never destructive.
+  const exampleDest = path.join(target, ".opencode", CONFIG_EXAMPLE);
+  copyFile(configSrc, exampleDest);
+  console.log(`  [reference] .opencode/${CONFIG_EXAMPLE}`);
+}
+
+/* ------------------------------ project-control ------------------------------ */
+
+function installProjectControl() {
+  const pcSrc = path.join(PKG_ROOT, "core", "project-control");
+  if (!fs.existsSync(pcSrc)) return;
+  const pcDest = path.join(target, "project-control");
+  if (fs.existsSync(pcDest)) {
+    stats.skippedGroups++;
+    console.log("  [SKIP    ] project-control/ — exists (user-owned state). Skeleton not installed.");
+    return;
+  }
+  for (const f of walkFiles(pcSrc)) {
+    const relF = toPosix(path.relative(pcSrc, f));
+    const d = path.join(pcDest, relF);
+    copyFile(f, d);
+    ownership.files[`project-control/${relF}`] = sha256(fs.readFileSync(f));
+    stats.installed++;
+    console.log(`  [install ] project-control/${relF}`);
+  }
+}
+
+/* ----------------------------------- run ----------------------------------- */
+
+console.log(`\n@tera/core v${pkg.version} — install`);
+console.log(`  target workspace : ${target}\n`);
+
+installGroup({ name: "agents", src: path.join(PKG_ROOT, "agents"), dest: path.join(target, ".opencode", "agents") });
+installGroup({ name: "commands", src: path.join(PKG_ROOT, "commands"), dest: path.join(target, ".opencode", "commands") });
+installGroup({ name: "tera-system", src: path.join(PKG_ROOT, "core", "tera-system"), dest: path.join(target, "tera-system") });
+installGroup({ name: "tools", src: path.join(PKG_ROOT, "tools"), dest: path.join(target, "tools") });
+installConfig();
+installProjectControl();
+
+/* -------------------------------- persist log -------------------------------- */
+
+const manifest = {
+  name: pkg.name,
+  version: pkg.version,
+  installedAt: new Date().toISOString(),
+  target,
+  files: ownership.files,
+  conflicts: stats.conflicts,
+  summary: {
+    installed: stats.installed,
+    updated: stats.updated,
+    identical: stats.identical,
+    skippedGroups: stats.skippedGroups,
+    conflicts: stats.conflicts.length,
+  },
+};
+
+const manifestPath = path.join(target, ".opencode", MANIFEST_NAME);
+fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
+fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+
+/* ------------------- license state (non-blocking, never breaks install) ------------------- */
+try {
+  const stateFile = path.join(target, ".tera", "license.state.json");
+  let licenseKey = (readLicenseState(stateFile) || {}).licenseKey;
+  if (!licenseKey) licenseKey = process.env.TERA_LICENSE_KEY || undefined;
+  const state = assessLicenseState(licenseKey);
+  writeLicenseState(stateFile, {
+    state: state.state,
+    reason: state.reason,
+    licenseKey: licenseKey || null,
+    expiresAt: state.expiresAt || null,
+    checkedAt: new Date().toISOString(),
+  });
+  console.log(`  [license ] state=${state.state} (${state.reason})`);
+} catch (err) {
+  console.log(`  [license ] skipped (${err.message}) — install continues`);
+}
+
+console.log("\n  summary:");
+console.log(`    installed : ${stats.installed}`);
+console.log(`    updated   : ${stats.updated}`);
+console.log(`    identical : ${stats.identical}`);
+console.log(`    conflicts : ${stats.conflicts.length} (your files kept untouched)`);
+console.log(`    skipped   : ${stats.skippedGroups} group(s) — user-owned state`);
+console.log(`  ownership log : ${path.join(".opencode", MANIFEST_NAME)}\n`);
+
+if (stats.conflicts.length > 0) {
+  console.log("  ⚠ conflicts — your files were kept. Review them before relying on Tera content.");
+  process.exitCode = 0;
+}