human2ai 0.1.0

package/migrations/0001_projects_and_sessions.sql

@@ -0,0 +1,45 @@
+CREATE TABLE projects (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL CHECK (length(trim(name)) > 0),
+  description TEXT,
+  revision INTEGER NOT NULL DEFAULT 1 CHECK (revision > 0),
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+) STRICT;
+
+CREATE TABLE session_types (
+  code TEXT PRIMARY KEY
+) STRICT;
+
+INSERT INTO session_types (code)
+VALUES ('image-composition'), ('ui-layout');
+
+CREATE TABLE sessions (
+  id TEXT PRIMARY KEY,
+  project_id TEXT,
+  session_type TEXT NOT NULL,
+  title TEXT NOT NULL CHECK (length(trim(title)) > 0),
+  lifecycle_stage TEXT NOT NULL DEFAULT 'draft'
+    CHECK (lifecycle_stage IN ('draft', 'interpreted', 'approved', 'exported')),
+  revision INTEGER NOT NULL DEFAULT 1 CHECK (revision > 0),
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE SET NULL,
+  FOREIGN KEY (session_type) REFERENCES session_types(code)
+) STRICT;
+
+CREATE INDEX sessions_project_updated_idx
+  ON sessions (project_id, updated_at DESC);
+
+CREATE INDEX sessions_type_updated_idx
+  ON sessions (session_type, updated_at DESC);
+
+CREATE TABLE composition_sessions (
+  session_id TEXT PRIMARY KEY,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE TABLE ui_sessions (
+  session_id TEXT PRIMARY KEY,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+) STRICT;

package/migrations/0002_composition_versions_and_refinements.sql

@@ -0,0 +1,26 @@
+CREATE TABLE composition_draft_versions (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  revision INTEGER NOT NULL CHECK (revision > 0),
+  fingerprint TEXT NOT NULL,
+  draft_json TEXT NOT NULL CHECK (json_valid(draft_json)),
+  created_at TEXT NOT NULL,
+  UNIQUE (session_id, revision),
+  FOREIGN KEY (session_id) REFERENCES composition_sessions(session_id) ON DELETE CASCADE
+) STRICT;
+
+CREATE INDEX composition_draft_versions_session_created_idx
+  ON composition_draft_versions (session_id, revision DESC);
+
+CREATE TABLE composition_refinement_runs (
+  id TEXT PRIMARY KEY,
+  source_draft_version_id TEXT NOT NULL,
+  plan_json TEXT NOT NULL CHECK (json_valid(plan_json)),
+  result_json TEXT NOT NULL CHECK (json_valid(result_json)),
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (source_draft_version_id)
+    REFERENCES composition_draft_versions(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE INDEX composition_refinement_runs_source_created_idx
+  ON composition_refinement_runs (source_draft_version_id, created_at DESC);

package/migrations/0003_ui_sketch_draft_versions.sql

@@ -0,0 +1,12 @@
+CREATE TABLE ui_sketch_draft_versions (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  revision INTEGER NOT NULL CHECK (revision > 0),
+  draft_json TEXT NOT NULL CHECK (json_valid(draft_json)),
+  created_at TEXT NOT NULL,
+  UNIQUE (session_id, revision),
+  FOREIGN KEY (session_id) REFERENCES ui_sessions(session_id) ON DELETE CASCADE
+) STRICT;
+
+CREATE INDEX ui_sketch_draft_versions_session_created_idx
+  ON ui_sketch_draft_versions (session_id, revision DESC);

package/migrations/0004_image_assets.sql

@@ -0,0 +1,16 @@
+CREATE TABLE image_assets (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  relative_path TEXT NOT NULL UNIQUE,
+  original_filename TEXT NOT NULL,
+  mime_type TEXT NOT NULL CHECK (mime_type IN ('image/png', 'image/jpeg', 'image/webp')),
+  byte_size INTEGER NOT NULL CHECK (byte_size > 0),
+  width INTEGER NOT NULL CHECK (width > 0),
+  height INTEGER NOT NULL CHECK (height > 0),
+  sha256 TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE INDEX image_assets_session_created_idx
+  ON image_assets (session_id, created_at DESC);

package/migrations/0005_style_library.sql

@@ -0,0 +1,31 @@
+CREATE TABLE style_entries (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL CHECK (length(trim(name)) > 0),
+  category TEXT NOT NULL CHECK (category IN ('visual', 'ui')),
+  creator_type TEXT NOT NULL CHECK (creator_type IN ('user', 'agent')),
+  description TEXT NOT NULL CHECK (length(trim(description)) > 0),
+  revision INTEGER NOT NULL DEFAULT 1 CHECK (revision > 0),
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+) STRICT;
+
+CREATE INDEX style_entries_updated_idx
+  ON style_entries (updated_at DESC, id);
+
+CREATE TABLE style_reference_images (
+  id TEXT PRIMARY KEY,
+  style_id TEXT NOT NULL,
+  relative_path TEXT NOT NULL UNIQUE,
+  original_filename TEXT NOT NULL,
+  mime_type TEXT NOT NULL CHECK (mime_type IN ('image/png', 'image/jpeg', 'image/webp')),
+  byte_size INTEGER NOT NULL CHECK (byte_size > 0),
+  width INTEGER NOT NULL CHECK (width > 0),
+  height INTEGER NOT NULL CHECK (height > 0),
+  position INTEGER NOT NULL CHECK (position >= 0),
+  created_at TEXT NOT NULL,
+  UNIQUE (style_id, position),
+  FOREIGN KEY (style_id) REFERENCES style_entries(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE INDEX style_reference_images_style_position_idx
+  ON style_reference_images (style_id, position);

package/migrations/0006_session_styles.sql

@@ -0,0 +1,6 @@
+ALTER TABLE style_entries ADD COLUMN prompt_summary TEXT;
+ALTER TABLE sessions ADD COLUMN style_id TEXT REFERENCES style_entries(id) ON DELETE SET NULL;
+CREATE INDEX sessions_style_idx ON sessions(style_id);
+
+ALTER TABLE composition_draft_versions ADD COLUMN style_processing_json TEXT;
+ALTER TABLE ui_sketch_draft_versions ADD COLUMN style_processing_json TEXT;

package/migrations/0007_svg_image_assets.sql

@@ -0,0 +1,19 @@
+CREATE TABLE image_assets_with_svg (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  relative_path TEXT NOT NULL UNIQUE,
+  original_filename TEXT NOT NULL,
+  mime_type TEXT NOT NULL CHECK (mime_type IN ('image/png', 'image/jpeg', 'image/webp', 'image/svg+xml')),
+  byte_size INTEGER NOT NULL CHECK (byte_size > 0),
+  width INTEGER NOT NULL CHECK (width > 0),
+  height INTEGER NOT NULL CHECK (height > 0),
+  sha256 TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+) STRICT;
+
+INSERT INTO image_assets_with_svg SELECT * FROM image_assets;
+DROP TABLE image_assets;
+ALTER TABLE image_assets_with_svg RENAME TO image_assets;
+CREATE INDEX image_assets_session_created_idx
+  ON image_assets (session_id, created_at DESC);

package/migrations/0008_spatial_spaces.sql

@@ -0,0 +1,20 @@
+INSERT INTO session_types (code) VALUES ('spatial');
+
+CREATE TABLE spatial_sessions (
+  session_id TEXT PRIMARY KEY,
+  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE TABLE spatial_draft_versions (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  revision INTEGER NOT NULL CHECK (revision > 0),
+  draft_json TEXT NOT NULL CHECK (json_valid(draft_json)),
+  created_at TEXT NOT NULL,
+  style_processing_json TEXT CHECK (style_processing_json IS NULL OR json_valid(style_processing_json)),
+  UNIQUE (session_id, revision),
+  FOREIGN KEY (session_id) REFERENCES spatial_sessions(session_id) ON DELETE CASCADE
+) STRICT;
+
+CREATE INDEX spatial_draft_versions_session_revision_idx
+  ON spatial_draft_versions (session_id, revision DESC);

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "human2ai",
+  "version": "0.1.0",
+  "description": "Local visual collaboration workspace for people and AI agents, with a browser UI and CLI.",
+  "license": "MIT",
+  "author": "贾思斋",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yisi-ai/human2ai.git"
+  },
+  "homepage": "https://github.com/yisi-ai/human2ai#readme",
+  "bugs": "https://github.com/yisi-ai/human2ai/issues",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "bin": {
+    "human2ai": "./dist/cli/main.js",
+    "h2a": "./dist/cli/main.js"
+  },
+  "files": [
+    "dist",
+    "web/out",
+    "migrations",
+    "schemas",
+    "skills/human2ai",
+    "locales/en/common.json",
+    "licenses",
+    "assets/quaternius"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "npm@11",
+  "workspaces": [
+    "web",
+    "design-system/surfaces/*",
+    "storybook"
+  ],
+  "scripts": {
+    "dev": "node scripts/dev.mjs",
+    "dev:web": "npm run dev --workspace web",
+    "cli": "tsx src/cli/main.ts",
+    "server:dev": "tsx watch src/server/start.ts",
+    "build": "npm run build:server && npm run build:web",
+    "build:server": "tsc -p tsconfig.build.json",
+    "build:web": "npm run build --workspace web",
+    "prepack": "npm run build && node scripts/prepare-package.mjs && node scripts/check-package.mjs",
+    "pack:check": "npm run prepack",
+    "repository:check": "node scripts/check-repository.mjs",
+    "typecheck": "npm run typecheck:server && npm run typecheck:web && npm run storybook:typecheck",
+    "typecheck:server": "tsc --noEmit -p tsconfig.json",
+    "typecheck:web": "npm run typecheck --workspace web",
+    "domain-baseline:check": "node scripts/domain-baseline.mjs check",
+    "domain-baseline:test": "node scripts/domain-baseline.mjs test",
+    "i18n:check": "node scripts/check-i18n.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "storybook": "npm run storybook --workspace @human2ai/storybook",
+    "storybook:build": "npm run build --workspace @human2ai/storybook",
+    "storybook:typecheck": "npm run typecheck --workspace @human2ai/storybook",
+    "yisiui": "node .yisiui/launcher.mjs"
+  },
+  "dependencies": {
+    "@fastify/static": "10.1.3",
+    "ajv": "8.20.0",
+    "better-sqlite3": "13.0.3",
+    "fastify": "5.12.1",
+    "saxes": "6.0.0",
+    "sharp": "0.35.3",
+    "three": "0.186.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "9.6.0",
+    "@types/node": "22.15.3",
+    "@types/three": "0.185.0",
+    "tsx": "4.23.12",
+    "typescript": "5.8.3",
+    "vitest": "4.1.11"
+  }
+}

package/schemas/composition-draft.schema.json

@@ -0,0 +1,234 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yisi.local/schemas/composition-draft.schema.json",
+  "title": "User Composition Draft",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "kind", "processingSemantic", "frame", "overallNote", "focusPoints", "areas", "images"],
+  "allOf": [
+    { "if": { "required": ["states"] }, "then": { "required": ["activeStateId"] } },
+    { "if": { "required": ["activeStateId"] }, "then": { "required": ["states"] } }
+  ],
+  "properties": {
+    "activeStateId": { "type": "string", "minLength": 1 },
+    "states": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/state" } },
+    "layerOrder": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "version": { "const": 1 },
+    "kind": { "const": "composition-draft" },
+    "processingSemantic": { "enum": [null, "scene-composition", "editorial-layout"] },
+    "frame": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["width", "height"],
+      "properties": {
+        "width": { "type": "integer", "minimum": 256, "maximum": 4096 },
+        "height": { "type": "integer", "minimum": 256, "maximum": 4096 },
+        "bounds": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["x", "y", "width", "height"],
+          "properties": {
+            "x": { "type": "number" },
+            "y": { "type": "number" },
+            "width": { "type": "number", "exclusiveMinimum": 0 },
+            "height": { "type": "number", "exclusiveMinimum": 0 }
+          }
+        }
+      }
+    },
+    "overallNote": { "type": "string" },
+    "focusPoints": {
+      "type": "array",
+      "maxItems": 3,
+      "items": { "$ref": "#/$defs/point" }
+    },
+    "directionLine": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "x", "y", "rotation", "note", "annotation", "semanticType", "shotScale"],
+          "properties": {
+            "id": { "const": "direction-1" },
+            "x": { "type": "number" },
+            "y": { "type": "number" },
+            "rotation": { "type": "number" },
+            "origin": { "enum": ["user", "agent", "import"] },
+            "note": { "type": "string" },
+            "annotation": { "type": "string" },
+            "semanticType": { "type": "string" },
+            "shotScale": { "enum": ["auto", "foreground", "midground", "background"] }
+          }
+        }
+      ]
+    },
+    "areas": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "primitive", "x", "y", "area", "aspect", "visualWeight", "note", "annotation", "semanticType", "shotScale"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^area-[0-9]+$" },
+          "primitive": { "enum": ["circle", "triangle", "quadrilateral"] },
+          "x": { "type": "number" },
+          "y": { "type": "number" },
+          "area": { "type": "number", "exclusiveMinimum": 0 },
+          "aspect": { "enum": ["square", "free", "landscape", "portrait"] },
+          "visualWeight": { "enum": ["auto", "high", "medium", "low", "decorative"] },
+          "displayText": { "type": "string" },
+          "isLightSource": { "type": "boolean" },
+          "rotation": { "type": "number" },
+          "width": { "type": "number", "exclusiveMinimum": 0 },
+          "height": { "type": "number", "exclusiveMinimum": 0 },
+          "origin": { "enum": ["user", "agent", "import"] },
+          "note": { "type": "string" },
+          "annotation": { "type": "string" },
+          "semanticType": { "type": "string" },
+          "shotScale": { "enum": ["auto", "foreground", "midground", "background"] }
+        },
+        "allOf": [
+          {
+            "if": { "properties": { "aspect": { "const": "free" } } },
+            "then": { "required": ["width", "height"] }
+          },
+          {
+            "if": {
+              "properties": { "semanticType": { "const": "text-region" } },
+              "required": ["semanticType"]
+            },
+            "then": { "required": ["displayText"], "properties": { "isLightSource": { "const": false } } },
+            "else": { "not": { "required": ["displayText"] } }
+          }
+        ]
+      }
+    },
+    "images": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "x", "y", "width", "height", "rotation", "visualWeight", "assetId", "crop", "note", "annotation", "semanticType", "shotScale"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^image-[0-9]+$" },
+          "x": { "type": "number" },
+          "y": { "type": "number" },
+          "width": { "type": "number", "exclusiveMinimum": 0 },
+          "height": { "type": "number", "exclusiveMinimum": 0 },
+          "rotation": { "type": "number" },
+          "visualWeight": { "enum": ["auto", "high", "medium", "low", "decorative"] },
+          "cameraReference": {
+            "type": "object", "additionalProperties": false,
+            "required": ["sessionId", "cameraId", "renderedRevision"],
+            "properties": {
+              "sessionId": { "type": "string", "minLength": 1 },
+              "cameraId": { "type": "string", "minLength": 1 },
+              "renderedRevision": { "type": "integer", "minimum": 0 }
+            }
+          },
+          "assetId": {
+            "type": ["string", "null"],
+            "minLength": 1
+          },
+          "crop": {
+            "oneOf": [
+              { "type": "null" },
+              { "$ref": "#/$defs/imageCrop" }
+            ]
+          },
+          "origin": { "enum": ["user", "agent", "import"] },
+          "note": { "type": "string" },
+          "annotation": { "type": "string" },
+          "semanticType": { "type": "string" },
+          "shotScale": { "enum": ["auto", "foreground", "midground", "background"] }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "state": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "number", "layout"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 100 },
+        "number": { "type": "integer", "minimum": 1 },
+        "name": { "type": "string", "minLength": 1, "maxLength": 100 },
+        "layout": {
+          "type": "object", "additionalProperties": false,
+          "required": ["frame", "layerOrder", "focusPoints", "directionLine", "areas", "images"],
+          "properties": {
+            "frame": { "allOf": [{ "$ref": "#/properties/frame" }, { "type": "object", "required": ["bounds"] }] },
+            "layerOrder": { "$ref": "#/properties/layerOrder" },
+            "focusPoints": { "type": "array", "maxItems": 3, "items": { "$ref": "#/$defs/layoutPoint" } },
+            "directionLine": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/layoutDirection" }] },
+            "areas": { "type": "array", "items": { "$ref": "#/$defs/layoutArea" } },
+            "images": { "type": "array", "items": { "$ref": "#/$defs/layoutImage" } }
+          }
+        }
+      }
+    },
+    "layoutPoint": {
+      "type": "object", "additionalProperties": false, "required": ["id", "x", "y"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^focus-[0-9]+$" },
+        "x": { "type": "number" }, "y": { "type": "number" }
+      }
+    },
+    "layoutDirection": {
+      "type": "object", "additionalProperties": false, "required": ["id", "x", "y", "rotation"],
+      "properties": {
+        "id": { "const": "direction-1" }, "x": { "type": "number" }, "y": { "type": "number" },
+        "rotation": { "type": "number" }
+      }
+    },
+    "layoutArea": {
+      "type": "object", "additionalProperties": false, "required": ["id", "x", "y", "area", "aspect"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^area-[0-9]+$" },
+        "x": { "type": "number" }, "y": { "type": "number" },
+        "area": { "type": "number", "exclusiveMinimum": 0 },
+        "aspect": { "enum": ["square", "free", "landscape", "portrait"] },
+        "rotation": { "type": "number" },
+        "width": { "type": "number", "exclusiveMinimum": 0 },
+        "height": { "type": "number", "exclusiveMinimum": 0 }
+      },
+      "allOf": [{ "if": { "properties": { "aspect": { "const": "free" } } }, "then": { "required": ["width", "height"] } }]
+    },
+    "layoutImage": {
+      "type": "object", "additionalProperties": false, "required": ["id", "x", "y", "width", "height", "rotation"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^image-[0-9]+$" },
+        "x": { "type": "number" }, "y": { "type": "number" },
+        "width": { "type": "number", "exclusiveMinimum": 0 },
+        "height": { "type": "number", "exclusiveMinimum": 0 }, "rotation": { "type": "number" }
+      }
+    },
+    "imageCrop": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["x", "y", "width", "height"],
+      "properties": {
+        "x": { "type": "number", "minimum": 0, "maximum": 1 },
+        "y": { "type": "number", "minimum": 0, "maximum": 1 },
+        "width": { "type": "number", "exclusiveMinimum": 0, "maximum": 1 },
+        "height": { "type": "number", "exclusiveMinimum": 0, "maximum": 1 }
+      }
+    },
+    "point": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "x", "y", "note", "annotation", "semanticType", "shotScale"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^focus-[0-9]+$" },
+        "x": { "type": "number" },
+        "y": { "type": "number" },
+        "origin": { "enum": ["user", "agent", "import"] },
+        "note": { "type": "string" },
+        "annotation": { "type": "string" },
+        "semanticType": { "type": "string" },
+        "shotScale": { "enum": ["auto", "foreground", "midground", "background"] }
+      }
+    }
+  }
+}