@archal/cli 0.7.12 → 0.9.0

package/twin-assets/supabase/seeds/saas-starter.sql

@@ -0,0 +1,175 @@
+-- SaaS starter seed: a multi-tenant SaaS application with RLS, functions, and triggers
+-- Demonstrates Supabase best practices for user isolation and server-side logic
+
+-- Users table (auth.users equivalent for data layer)
+CREATE TABLE users (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  email text NOT NULL UNIQUE,
+  full_name text NOT NULL,
+  avatar_url text,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE users ENABLE ROW LEVEL SECURITY;
+
+-- Profiles table (public profile information)
+CREATE TABLE profiles (
+  id uuid PRIMARY KEY REFERENCES users(id) ON DELETE CASCADE,
+  username text UNIQUE NOT NULL,
+  bio text,
+  website text,
+  company text,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE profiles ENABLE ROW LEVEL SECURITY;
+
+-- Subscriptions table (billing/plan info)
+CREATE TABLE subscriptions (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  plan text NOT NULL DEFAULT 'free' CHECK (plan IN ('free', 'pro', 'enterprise')),
+  status text NOT NULL DEFAULT 'active' CHECK (status IN ('active', 'canceled', 'past_due', 'trialing')),
+  current_period_start timestamptz NOT NULL DEFAULT now(),
+  current_period_end timestamptz NOT NULL DEFAULT now() + interval '30 days',
+  cancel_at_period_end boolean NOT NULL DEFAULT false,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE subscriptions ENABLE ROW LEVEL SECURITY;
+
+-- Teams table (for multi-tenant features)
+CREATE TABLE teams (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  name text NOT NULL,
+  slug text UNIQUE NOT NULL,
+  owner_id uuid NOT NULL REFERENCES users(id),
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE teams ENABLE ROW LEVEL SECURITY;
+
+-- Team members junction
+CREATE TABLE team_members (
+  team_id uuid NOT NULL REFERENCES teams(id) ON DELETE CASCADE,
+  user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  role text NOT NULL DEFAULT 'member' CHECK (role IN ('owner', 'admin', 'member', 'viewer')),
+  joined_at timestamptz NOT NULL DEFAULT now(),
+  PRIMARY KEY (team_id, user_id)
+);
+
+ALTER TABLE team_members ENABLE ROW LEVEL SECURITY;
+
+-- RLS policies: users can read/update their own data
+CREATE POLICY "Users can read own data" ON users FOR SELECT USING (true);
+CREATE POLICY "Users can update own data" ON users FOR UPDATE USING (id = id);
+
+CREATE POLICY "Profiles are publicly readable" ON profiles FOR SELECT USING (true);
+CREATE POLICY "Users can update own profile" ON profiles FOR UPDATE USING (id = id);
+CREATE POLICY "Users can insert own profile" ON profiles FOR INSERT WITH CHECK (id = id);
+
+CREATE POLICY "Users can read own subscriptions" ON subscriptions FOR SELECT USING (user_id = user_id);
+
+CREATE POLICY "Team members can read team" ON teams FOR SELECT USING (true);
+CREATE POLICY "Team owners can update team" ON teams FOR UPDATE USING (owner_id = owner_id);
+
+CREATE POLICY "Members can read team membership" ON team_members FOR SELECT USING (true);
+
+-- Function: handle new user signup (creates profile automatically)
+CREATE OR REPLACE FUNCTION handle_new_user()
+RETURNS trigger
+LANGUAGE plpgsql
+SECURITY DEFINER
+AS $$
+BEGIN
+  INSERT INTO profiles (id, username)
+  VALUES (NEW.id, split_part(NEW.email, '@', 1));
+  RETURN NEW;
+END;
+$$;
+
+-- Trigger: auto-create profile on user insert
+CREATE TRIGGER on_user_created
+  AFTER INSERT ON users
+  FOR EACH ROW
+  EXECUTE FUNCTION handle_new_user();
+
+-- Function: update updated_at timestamp
+CREATE OR REPLACE FUNCTION update_updated_at()
+RETURNS trigger
+LANGUAGE plpgsql
+AS $$
+BEGIN
+  NEW.updated_at = now();
+  RETURN NEW;
+END;
+$$;
+
+-- Triggers: auto-update timestamps
+CREATE TRIGGER update_users_updated_at
+  BEFORE UPDATE ON users
+  FOR EACH ROW
+  EXECUTE FUNCTION update_updated_at();
+
+CREATE TRIGGER update_profiles_updated_at
+  BEFORE UPDATE ON profiles
+  FOR EACH ROW
+  EXECUTE FUNCTION update_updated_at();
+
+CREATE TRIGGER update_subscriptions_updated_at
+  BEFORE UPDATE ON subscriptions
+  FOR EACH ROW
+  EXECUTE FUNCTION update_updated_at();
+
+CREATE TRIGGER update_teams_updated_at
+  BEFORE UPDATE ON teams
+  FOR EACH ROW
+  EXECUTE FUNCTION update_updated_at();
+
+-- Indexes
+CREATE INDEX idx_subscriptions_user_id ON subscriptions(user_id);
+CREATE INDEX idx_teams_owner_id ON teams(owner_id);
+CREATE INDEX idx_team_members_user_id ON team_members(user_id);
+
+-- Seed data
+INSERT INTO users (id, email, full_name) VALUES
+  ('a1b2c3d4-e5f6-7890-abcd-ef1234567890', 'alice@startup.io', 'Alice Johnson'),
+  ('b2c3d4e5-f6a7-8901-bcde-f12345678901', 'bob@startup.io', 'Bob Martinez'),
+  ('c3d4e5f6-a7b8-9012-cdef-123456789012', 'carol@bigcorp.com', 'Carol Chen'),
+  ('d4e5f6a7-b8c9-0123-defa-234567890123', 'dave@freelance.dev', 'Dave Wilson'),
+  ('e5f6a7b8-c9d0-1234-efab-345678901234', 'eve@startup.io', 'Eve Garcia');
+
+INSERT INTO subscriptions (user_id, plan, status) VALUES
+  ('a1b2c3d4-e5f6-7890-abcd-ef1234567890', 'pro', 'active'),
+  ('b2c3d4e5-f6a7-8901-bcde-f12345678901', 'pro', 'active'),
+  ('c3d4e5f6-a7b8-9012-cdef-123456789012', 'enterprise', 'active'),
+  ('d4e5f6a7-b8c9-0123-defa-234567890123', 'free', 'active'),
+  ('e5f6a7b8-c9d0-1234-efab-345678901234', 'pro', 'trialing');
+
+INSERT INTO teams (name, slug, owner_id) VALUES
+  ('Startup Team', 'startup-team', 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'),
+  ('BigCorp Engineering', 'bigcorp-eng', 'c3d4e5f6-a7b8-9012-cdef-123456789012');
+
+INSERT INTO team_members (team_id, user_id, role)
+SELECT t.id, u.id, CASE
+  WHEN u.id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890' THEN 'owner'
+  ELSE 'member'
+END
+FROM teams t, users u
+WHERE t.slug = 'startup-team'
+  AND u.email IN ('alice@startup.io', 'bob@startup.io', 'eve@startup.io');
+
+INSERT INTO team_members (team_id, user_id, role)
+SELECT t.id, u.id, 'owner'
+FROM teams t, users u
+WHERE t.slug = 'bigcorp-eng' AND u.email = 'carol@bigcorp.com';
+
+-- Record migrations
+INSERT INTO supabase_migrations.schema_migrations (version, name, statements) VALUES
+  ('20250101000000_init', 'create_saas_schema', 'CREATE TABLE users ...; CREATE TABLE profiles ...; CREATE TABLE subscriptions ...; CREATE TABLE teams ...; CREATE TABLE team_members ...;'),
+  ('20250101000001_rls', 'enable_rls_policies', 'ALTER TABLE ... ENABLE ROW LEVEL SECURITY; CREATE POLICY ...;'),
+  ('20250101000002_functions', 'create_functions_triggers', 'CREATE FUNCTION handle_new_user ...; CREATE TRIGGER ...;');

package/twin-assets/telegram/fidelity.json

@@ -0,0 +1,19 @@
+{
+  "twin": "telegram",
+  "api": "telegram-bot-api",
+  "version": "0.1.0",
+  "capabilities": [
+    {
+      "name": "getMe (approved cold-start tool)",
+      "supported": true
+    },
+    {
+      "name": "getUpdates (approved cold-start tool)",
+      "supported": true
+    },
+    {
+      "name": "sendMessage (approved cold-start tool)",
+      "supported": true
+    }
+  ]
+}

package/twin-assets/telegram/seeds/empty.json

@@ -0,0 +1 @@
+{}

package/twin-assets/telegram/seeds/harvested.json

@@ -0,0 +1,130 @@
+{
+  "botProfiles": [
+    {
+      "id": 1,
+      "createdAt": "2026-03-14T04:55:49.843Z",
+      "updatedAt": "2026-03-14T04:55:49.843Z",
+      "payload": {
+        "id": 8620849624,
+        "is_bot": true,
+        "first_name": "twingen",
+        "username": "twingen_bot",
+        "can_join_groups": true,
+        "can_read_all_group_messages": false,
+        "supports_inline_queries": false,
+        "can_connect_to_business": false,
+        "has_main_web_app": false,
+        "has_topics_enabled": false,
+        "allows_users_to_create_topics": false
+      },
+      "telegramUserId": 8620849624
+    }
+  ],
+  "users": [
+    {
+      "id": 1,
+      "createdAt": "2026-03-14T04:55:49.843Z",
+      "updatedAt": "2026-03-14T04:55:49.843Z",
+      "payload": {
+        "id": 8620849624,
+        "is_bot": true,
+        "first_name": "twingen",
+        "username": "twingen_bot",
+        "can_join_groups": true,
+        "can_read_all_group_messages": false,
+        "supports_inline_queries": false,
+        "can_connect_to_business": false,
+        "has_main_web_app": false,
+        "has_topics_enabled": false,
+        "allows_users_to_create_topics": false
+      },
+      "telegramUserId": 8620849624
+    },
+    {
+      "id": 2,
+      "createdAt": "2026-03-14T04:55:49.843Z",
+      "updatedAt": "2026-03-14T04:55:49.843Z",
+      "payload": {
+        "id": 999000001,
+        "is_bot": false,
+        "first_name": "Test",
+        "last_name": "User",
+        "language_code": "en"
+      },
+      "telegramUserId": 999000001
+    }
+  ],
+  "chats": [
+    {
+      "id": 1,
+      "createdAt": "2026-03-14T04:55:49.843Z",
+      "updatedAt": "2026-03-14T04:55:49.843Z",
+      "payload": {
+        "id": 999000001,
+        "first_name": "Test",
+        "last_name": "User",
+        "type": "private"
+      },
+      "telegramChatId": 999000001
+    }
+  ],
+  "messages": [
+    {
+      "id": 1,
+      "createdAt": "2026-03-14T04:55:49.843Z",
+      "updatedAt": "2026-03-14T04:55:49.843Z",
+      "payload": {
+        "message_id": 111,
+        "from": {
+          "id": 8620849624,
+          "is_bot": true,
+          "first_name": "twingen",
+          "username": "twingen_bot"
+        },
+        "chat": {
+          "id": 999000001,
+          "first_name": "Test",
+          "last_name": "User",
+          "type": "private"
+        },
+        "date": 1773464149,
+        "text": "archal telegram fixture harvest 2026-03-14T04:55:49.194Z"
+      },
+      "telegramMessageId": 111,
+      "chatId": 999000001,
+      "fromTelegramUserId": 8620849624,
+      "date": 1773464149,
+      "text": "archal telegram fixture harvest 2026-03-14T04:55:49.194Z"
+    }
+  ],
+  "updates": [
+    {
+      "id": 1,
+      "createdAt": "2026-03-14T04:55:49.843Z",
+      "updatedAt": "2026-03-14T04:55:49.843Z",
+      "payload": {
+        "update_id": 707484527,
+        "message": {
+          "message_id": 103,
+          "from": {
+            "id": 999000001,
+            "is_bot": false,
+            "first_name": "Test",
+            "last_name": "User",
+            "language_code": "en"
+          },
+          "chat": {
+            "id": 999000001,
+            "first_name": "Test",
+            "last_name": "User",
+            "type": "private"
+          },
+          "date": 1773461017,
+          "text": "message"
+        }
+      },
+      "telegramUpdateId": 707484527,
+      "kind": "message"
+    }
+  ]
+}

package/LICENSE

@@ -1,8 +0,0 @@
-Copyright (c) 2026 Archal Labs, Inc. All rights reserved.
-
-This software is proprietary and confidential. No part of this software may be
-reproduced, distributed, or transmitted in any form or by any means, including
-photocopying, recording, or other electronic or mechanical methods, without the
-prior written permission of Archal Labs, Inc.
-
-For licensing inquiries, visit https://archal.ai or contact support@archal.ai.

package/dist/api-client-D7SCA64V.js

@@ -1,23 +0,0 @@
-import {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-} from "./chunk-SVGN2AFT.js";
-import "./chunk-3RG5ZIWI.js";
-export {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-};

package/dist/api-client-DI7R3H4C.js

@@ -1,21 +0,0 @@
-import {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-} from "./chunk-WZXES7XO.js";
-import "./chunk-3RG5ZIWI.js";
-export {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-};

package/dist/api-client-EMMBIJU7.js

@@ -1,23 +0,0 @@
-import {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-} from "./chunk-A6WOU5RO.js";
-import "./chunk-3RG5ZIWI.js";
-export {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-};

package/dist/api-client-VYQMFDLN.js

@@ -1,23 +0,0 @@
-import {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-} from "./chunk-4FTU232H.js";
-import "./chunk-3RG5ZIWI.js";
-export {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-};

package/dist/api-client-WN45C63M.js

@@ -1,23 +0,0 @@
-import {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-} from "./chunk-VYCADG5E.js";
-import "./chunk-3RG5ZIWI.js";
-export {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-};

package/dist/api-client-ZOCVG6CC.js

@@ -1,21 +0,0 @@
-import {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-} from "./chunk-NZEPQ6IZ.js";
-import "./chunk-3RG5ZIWI.js";
-export {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-};

package/dist/api-client-ZUMDL3TP.js

@@ -1,23 +0,0 @@
-import {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-} from "./chunk-UOJHYCMX.js";
-import "./chunk-3RG5ZIWI.js";
-export {
-  endSession,
-  fetchAuthMe,
-  fetchTwinsCatalog,
-  finalizeSessionEvidence,
-  getSessionEvidence,
-  getSessionHealth,
-  getSessionStatus,
-  startSession,
-  updateTwinSelection
-};