@livestore/cli 0.0.0-snapshot-2ac5fd340c97c9e07fe4c5dc6d31d5132aa6557c.0

package/.claude/settings.local.json

@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:api.github.com)",
+      "Read(//Users/schickling/conductor/repo/livestore/livestore-cli/packages/@livestore/**)",
+      "WebSearch",
+      "WebFetch(domain:github.com)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/LICENSE

@@ -0,0 +1,201 @@
+                                Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Overengineering Studio
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/cli.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { Cli } from '@livestore/utils/node';
+export declare const command: Cli.Command.Command<"livestore", import("@effect/platform/HttpClient").HttpClient | Cli.Prompt.Prompt.Environment | import("@effect/platform/CommandExecutor").CommandExecutor, Error | import("@effect/platform/HttpClientError").ResponseError | import("@effect/platform/Error").PlatformError, {
+    readonly verbose: boolean;
+    readonly subcommand: import("effect/Option").Option<{
+        readonly subcommand: import("effect/Option").Option<{}>;
+    } | {
+        readonly example: import("effect/Option").Option<string>;
+        readonly branch: string;
+        readonly path: import("effect/Option").Option<string>;
+    } | {
+        readonly name: string;
+    }>;
+}>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,GAAG,EAAgB,MAAM,uBAAuB,CAAA;AAczD,eAAO,MAAM,OAAO;;;;;;;;;;;EAE+D,CAAA"}

package/dist/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { Effect, FetchHttpClient, Layer, Logger, LogLevel } from '@livestore/utils/effect';
+import { Cli, PlatformNode } from '@livestore/utils/node';
+import { mcpCommand } from "./commands/mcp.js";
+import { newProjectCommand } from "./commands/new-project.js";
+const helloCommand = Cli.Command.make('hello', {
+    name: Cli.Options.text('name').pipe(Cli.Options.withDefault('World')),
+}, Effect.fn(function* ({ name }) {
+    yield* Effect.log(`Hello, ${name}! 🎉`);
+}));
+export const command = Cli.Command.make('livestore', {
+    verbose: Cli.Options.boolean('verbose').pipe(Cli.Options.withDefault(false)),
+}).pipe(Cli.Command.withSubcommands([helloCommand, mcpCommand, newProjectCommand]));
+if (import.meta.main) {
+    const cli = Cli.Command.run(command, {
+        name: 'livestore',
+        version: '0.1.0',
+    });
+    const layer = Layer.mergeAll(PlatformNode.NodeContext.layer, FetchHttpClient.layer, Logger.minimumLogLevel(LogLevel.Info));
+    cli(process.argv).pipe(Effect.provide(layer), PlatformNode.NodeRuntime.runMain);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CACnC,OAAO,EACP;IACE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;CACtE,EACD,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAoB;IAC7C,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM,CAAC,CAAA;AACzC,CAAC,CAAC,CACH,CAAA;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;IACnD,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;CAC7E,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAA;AAEnF,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE;QACnC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAC1B,YAAY,CAAC,WAAW,CAAC,KAAK,EAC9B,eAAe,CAAC,KAAK,EACrB,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CACtC,CAAA;IAED,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;AACjF,CAAC"}

package/dist/commands/mcp-coach.d.ts

@@ -0,0 +1,15 @@
+import { AiError, AiTool, Effect, Schema } from '@livestore/utils/effect';
+export declare const coachTool: AiTool.AiTool<"livestore_coach", Schema.Struct<{
+    code: Schema.SchemaClass<string, string, never>;
+    codeType: Schema.optional<Schema.SchemaClass<string, string, never>>;
+}>, Schema.Struct<{
+    feedback: Schema.SchemaClass<string, string, never>;
+    score: Schema.optional<Schema.SchemaClass<number, number, never>>;
+    suggestions: Schema.Array$<Schema.SchemaClass<string, string, never>>;
+}>, typeof AiError.AiError, never>;
+export declare const coachToolHandler: (args_0: any) => Effect.Effect<{
+    feedback: string;
+    score: number | undefined;
+    suggestions: string[];
+}, AiError.AiError, never>;
+//# sourceMappingURL=mcp-coach.d.ts.map

package/dist/commands/mcp-coach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-coach.d.ts","sourceRoot":"","sources":["../../src/commands/mcp-coach.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EAEP,MAAM,EAEN,MAAM,EAGN,MAAM,EACP,MAAM,yBAAyB,CAAA;AAGhC,eAAO,MAAM,SAAS;;;;;;;kCA+BpB,CAAA;AAWF,eAAO,MAAM,gBAAgB;;;;0BAiE5B,CAAA"}

package/dist/commands/mcp-coach.js

@@ -0,0 +1,87 @@
+import { OpenAiClient, OpenAiLanguageModel } from '@effect/ai-openai';
+import { AiError, AiLanguageModel, AiTool, Config, Effect, FetchHttpClient, Layer, Schema, } from '@livestore/utils/effect';
+// Define the coach tool that analyzes LiveStore usage
+export const coachTool = AiTool.make('livestore_coach', {
+    description: 'Analyze LiveStore code (schemas, queries, mutations, etc.) and provide AI-powered feedback on best practices, performance, and improvements.',
+    parameters: {
+        code: Schema.String.annotations({
+            description: 'The LiveStore code to analyze (TypeScript/JavaScript)',
+        }),
+        codeType: Schema.optional(Schema.String.annotations({
+            description: "Type of code being analyzed: 'schema', 'query', 'mutation', 'component', or 'general'",
+        })),
+    },
+    success: Schema.Struct({
+        feedback: Schema.String.annotations({
+            description: 'AI-generated feedback and recommendations for the code',
+        }),
+        score: Schema.optional(Schema.Number.annotations({
+            description: 'Code quality score from 1-10 (optional)',
+        })),
+        suggestions: Schema.Array(Schema.String.annotations({
+            description: 'Specific actionable suggestions for improvement',
+        })).annotations({
+            description: 'List of specific improvement suggestions',
+        }),
+    }),
+    failure: AiError.AiError,
+});
+const OpenAiClientLayer = OpenAiClient.layerConfig({
+    apiKey: Config.redacted('OPENAI_API_KEY'),
+});
+const OpenAiModel = OpenAiLanguageModel.layer({
+    model: 'gpt-5-nano',
+});
+// Coach tool handler that uses OpenAI for analysis
+export const coachToolHandler = Effect.fnUntraced(function* ({ code, codeType }) {
+    // Build the analysis prompt
+    const codeTypeContext = codeType ? `This is ${codeType} code using LiveStore. ` : 'This is LiveStore code. ';
+    const prompt = `${codeTypeContext}Please review the following code and provide helpful feedback focusing on:
+
+1. LiveStore best practices and conventions
+2. Schema design and relationships (if applicable)
+3. Query optimization and performance
+4. Code structure and maintainability
+5. Security considerations
+6. Naming conventions
+7. TypeScript usage and type safety
+
+Code to review:
+\`\`\`typescript
+${code}
+\`\`\`
+
+Please provide:
+1. Overall assessment and quality score (1-10)
+2. Specific areas for improvement
+3. Best practice recommendations
+4. Any potential issues or concerns
+
+Format your response as constructive feedback that helps developers improve their LiveStore usage.`;
+    const systemPrompt = `You are an expert LiveStore developer and code reviewer. Provide constructive, specific, and actionable feedback on LiveStore code. Focus on best practices, performance, and maintainability.`;
+    // Get OpenAI client and call the API
+    const llm = yield* AiLanguageModel.AiLanguageModel;
+    const completion = yield* llm.generateText({ prompt, system: systemPrompt });
+    const feedback = completion.text ?? 'Unable to generate feedback';
+    // Extract suggestions from the feedback (simple approach)
+    const suggestions = feedback
+        .split('\n')
+        .filter((line) => line.trim().startsWith('-') ||
+        line.trim().startsWith('*') ||
+        line.trim().startsWith('•') ||
+        line.toLowerCase().includes('recommend') ||
+        line.toLowerCase().includes('consider') ||
+        line.toLowerCase().includes('improve'))
+        .map((line) => line.replace(/^[-*•]\s*/, '').trim())
+        .filter((suggestion) => suggestion.length > 10)
+        .slice(0, 5); // Limit to 5 suggestions
+    // Try to extract a score (simple regex approach)
+    const scoreMatch = feedback.match(/(?:score|rating|quality).*?(\d+(?:\.\d+)?)/i);
+    const score = scoreMatch ? Number.parseFloat(scoreMatch[1] ?? '0') : undefined;
+    return {
+        feedback,
+        score: score && score >= 1 && score <= 10 ? score : undefined,
+        suggestions,
+    };
+}, Effect.provide(Layer.provideMerge(OpenAiModel, OpenAiClientLayer)), Effect.provide(FetchHttpClient.layer), Effect.catchTag('ConfigError', (e) => Effect.die(e)));
+//# sourceMappingURL=mcp-coach.js.map

package/dist/commands/mcp-coach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-coach.js","sourceRoot":"","sources":["../../src/commands/mcp-coach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,EACL,OAAO,EACP,eAAe,EACf,MAAM,EACN,MAAM,EACN,MAAM,EACN,eAAe,EACf,KAAK,EACL,MAAM,GACP,MAAM,yBAAyB,CAAA;AAEhC,sDAAsD;AACtD,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;IACtD,WAAW,EACT,8IAA8I;IAChJ,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YAC9B,WAAW,EAAE,uDAAuD;SACrE,CAAC;QACF,QAAQ,EAAE,MAAM,CAAC,QAAQ,CACvB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YACxB,WAAW,EAAE,uFAAuF;SACrG,CAAC,CACH;KACF;IACD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YAClC,WAAW,EAAE,wDAAwD;SACtE,CAAC;QACF,KAAK,EAAE,MAAM,CAAC,QAAQ,CACpB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YACxB,WAAW,EAAE,yCAAyC;SACvD,CAAC,CACH;QACD,WAAW,EAAE,MAAM,CAAC,KAAK,CACvB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YACxB,WAAW,EAAE,iDAAiD;SAC/D,CAAC,CACH,CAAC,WAAW,CAAC;YACZ,WAAW,EAAE,0CAA0C;SACxD,CAAC;KACH,CAAC;IACF,OAAO,EAAE,OAAO,CAAC,OAAO;CACzB,CAAC,CAAA;AAEF,MAAM,iBAAiB,GAAG,YAAY,CAAC,WAAW,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CAC1C,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC;IAC5C,KAAK,EAAE,YAAY;CACpB,CAAC,CAAA;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAC/C,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC3B,4BAA4B;IAC5B,MAAM,eAAe,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,yBAAyB,CAAC,CAAC,CAAC,0BAA0B,CAAA;IAE5G,MAAM,MAAM,GAAG,GAAG,eAAe;;;;;;;;;;;;EAYnC,IAAI;;;;;;;;;mGAS6F,CAAA;IAE/F,MAAM,YAAY,GAAG,gMAAgM,CAAA;IAErN,qCAAqC;IACrC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,eAAe,CAAA;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAA;IAE5E,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,IAAI,6BAA6B,CAAA;IAEjE,0DAA0D;IAC1D,MAAM,WAAW,GAAa,QAAQ;SACnC,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CACL,CAAC,IAAY,EAAE,EAAE,CACf,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAC3B,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;QACxC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;QACvC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CACzC;SACA,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SAC3D,MAAM,CAAC,CAAC,UAAkB,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC;SACtD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA,CAAC,yBAAyB;IAExC,iDAAiD;IACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAChF,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE9E,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC7D,WAAW;KACZ,CAAA;AACH,CAAC,EACD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,EAClE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,EACrC,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACrD,CAAA"}

package/dist/commands/mcp-tools.d.ts

@@ -0,0 +1,41 @@
+import { AiTool, AiToolkit, Effect, Schema } from '@livestore/utils/effect';
+export declare const livestoreToolkit: AiToolkit.AiToolkit<AiTool.AiTool<"livestore_coach", Schema.Struct<{
+    code: Schema.SchemaClass<string, string, never>;
+    codeType: Schema.optional<Schema.SchemaClass<string, string, never>>;
+}>, Schema.Struct<{
+    feedback: Schema.SchemaClass<string, string, never>;
+    score: Schema.optional<Schema.SchemaClass<number, number, never>>;
+    suggestions: Schema.Array$<Schema.SchemaClass<string, string, never>>;
+}>, typeof import("@effect/ai/AiError").AiError, never> | AiTool.AiTool<"livestore_generate_schema", Schema.Struct<{
+    schemaType: Schema.SchemaClass<string, string, never>;
+    customDescription: Schema.optional<Schema.SchemaClass<string, string, never>>;
+}>, Schema.Struct<{
+    schemaCode: Schema.SchemaClass<string, string, never>;
+    explanation: Schema.SchemaClass<string, string, never>;
+}>, typeof Schema.Never, never> | AiTool.AiTool<"livestore_get_example_schema", Schema.Struct<{
+    type: Schema.SchemaClass<string, string, never>;
+}>, Schema.Struct<{
+    schemaCode: Schema.SchemaClass<string, string, never>;
+    description: Schema.SchemaClass<string, string, never>;
+}>, typeof Schema.Never, never>>;
+export declare const toolHandlers: {
+    livestore_coach: (args_0: any) => Effect.Effect<{
+        feedback: string;
+        score: number | undefined;
+        suggestions: string[];
+    }, import("@effect/ai/AiError").AiError, never>;
+    livestore_generate_schema: (args_0: {
+        readonly schemaType: string;
+        readonly customDescription?: string | undefined;
+    }) => Effect.Effect<{
+        schemaCode: string;
+        explanation: string;
+    }, never, never>;
+    livestore_get_example_schema: (args_0: {
+        readonly type: string;
+    }) => Effect.Effect<{
+        schemaCode: string;
+        description: string;
+    }, never, never>;
+};
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/commands/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../../src/commands/mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAQ3E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;gCA8C5B,CAAA;AAGD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;CA+GvB,CAAA"}

package/dist/commands/mcp-tools.js

@@ -0,0 +1,148 @@
+import { AiTool, AiToolkit, Effect, Schema } from '@livestore/utils/effect';
+import { blogSchemaContent } from "../mcp-content/schemas/blog.js";
+import { ecommerceSchemaContent } from "../mcp-content/schemas/ecommerce.js";
+import { socialSchemaContent } from "../mcp-content/schemas/social.js";
+import { todoSchemaContent } from "../mcp-content/schemas/todo.js";
+import { coachTool, coachToolHandler } from "./mcp-coach.js";
+// Create toolkit with tools and handlers following Tim Smart's pattern
+export const livestoreToolkit = AiToolkit.make(coachTool, AiTool.make('livestore_generate_schema', {
+    description: 'Generate a LiveStore schema for a specific use case. Choose from predefined types (todo, blog, social, ecommerce) or request a custom schema by providing a description.',
+    parameters: {
+        schemaType: Schema.String.annotations({
+            description: "Schema type: 'todo', 'blog', 'social', 'ecommerce', or 'custom'",
+        }),
+        customDescription: Schema.optional(Schema.String.annotations({
+            description: "For custom schemas: describe your data model needs (e.g., 'user management system with roles and permissions')",
+        })),
+    },
+    success: Schema.Struct({
+        schemaCode: Schema.String.annotations({
+            description: 'The generated LiveStore schema TypeScript code',
+        }),
+        explanation: Schema.String.annotations({
+            description: 'Brief explanation of the schema structure',
+        }),
+    }),
+}), AiTool.make('livestore_get_example_schema', {
+    description: 'Get a complete example LiveStore schema with TypeScript code. Returns ready-to-use schema definitions for common application types.',
+    parameters: {
+        type: Schema.String.annotations({
+            description: "Example type: 'todo', 'blog', 'social', or 'ecommerce'",
+        }),
+    },
+    success: Schema.Struct({
+        schemaCode: Schema.String.annotations({
+            description: 'The complete LiveStore schema code',
+        }),
+        description: Schema.String.annotations({
+            description: 'Description of what this schema models',
+        }),
+    }),
+})
+    .annotate(AiTool.Readonly, true)
+    .annotate(AiTool.Destructive, false));
+// Tool handlers using Tim Smart's pattern
+export const toolHandlers = livestoreToolkit.of({
+    livestore_coach: coachToolHandler,
+    livestore_generate_schema: Effect.fnUntraced(function* ({ schemaType, customDescription }) {
+        let schemaCode;
+        let explanation;
+        switch (schemaType.toLowerCase()) {
+            case 'todo':
+                schemaCode = todoSchemaContent;
+                explanation = 'Todo application schema with tasks, tags, and many-to-many relationships';
+                break;
+            case 'blog':
+                schemaCode = blogSchemaContent;
+                explanation = 'Blog platform schema with posts, comments, and publishing workflow';
+                break;
+            case 'social':
+                schemaCode = socialSchemaContent;
+                explanation = 'Social media schema with users, posts, follows, and likes';
+                break;
+            case 'ecommerce':
+                schemaCode = ecommerceSchemaContent;
+                explanation = 'E-commerce schema with products, categories, orders, and inventory';
+                break;
+            case 'custom': {
+                if (!customDescription) {
+                    schemaCode = `// Custom schema requested but no description provided
+import { Schema } from '@livestore/livestore'
+
+// Please provide a description of your data model needs
+export const CustomSchema = Schema.table('items', {
+  id: Schema.id,
+  name: Schema.text,
+  createdAt: Schema.datetime.default('now')
+})
+
+export const schema = Schema.create({
+  items: CustomSchema
+})`;
+                    explanation = 'Basic custom schema template - please provide more details about your requirements';
+                    break;
+                }
+                // Generate a basic custom schema based on description
+                const tableName = customDescription.toLowerCase().includes('user')
+                    ? 'users'
+                    : customDescription.toLowerCase().includes('product')
+                        ? 'products'
+                        : customDescription.toLowerCase().includes('post')
+                            ? 'posts'
+                            : 'items';
+                schemaCode = `// Custom schema based on: ${customDescription}
+import { Schema } from '@livestore/livestore'
+
+export const ${tableName.charAt(0).toUpperCase() + tableName.slice(0, -1)}Schema = Schema.table('${tableName}', {
+  id: Schema.id,
+  name: Schema.text,
+  description: Schema.text.optional(),
+  createdAt: Schema.datetime.default('now'),
+  updatedAt: Schema.datetime.default('now')
+})
+
+export const schema = Schema.create({
+  ${tableName}: ${tableName.charAt(0).toUpperCase() + tableName.slice(0, -1)}Schema
+})`;
+                explanation = `Custom schema generated for: ${customDescription}. This is a basic template - you may need to customize the fields based on your specific requirements.`;
+                break;
+            }
+            default:
+                schemaCode = todoSchemaContent;
+                explanation =
+                    'Unknown schema type, returning todo example. Available types: todo, blog, social, ecommerce, custom';
+        }
+        return { schemaCode, explanation };
+    }),
+    livestore_get_example_schema: Effect.fnUntraced(function* ({ type }) {
+        let schemaCode;
+        let description;
+        switch (type.toLowerCase()) {
+            case 'todo':
+                schemaCode = todoSchemaContent;
+                description =
+                    'Complete todo application with tasks, tags, and many-to-many relationships. Includes boolean completion status and timestamps.';
+                break;
+            case 'blog':
+                schemaCode = blogSchemaContent;
+                description =
+                    'Blog platform with posts and comments. Features published status, unique slugs, and author attribution.';
+                break;
+            case 'social':
+                schemaCode = socialSchemaContent;
+                description =
+                    'Social media platform with users, posts, follows, and likes. Includes user profiles and social interactions.';
+                break;
+            case 'ecommerce':
+                schemaCode = ecommerceSchemaContent;
+                description =
+                    'E-commerce platform with products, categories, orders, and inventory management. Features order items and status tracking.';
+                break;
+            default:
+                schemaCode = todoSchemaContent;
+                description = 'Default todo example (unknown type requested). Available types: todo, blog, social, ecommerce';
+        }
+        return { schemaCode, description };
+    }),
+});
+//# sourceMappingURL=mcp-tools.js.map

package/dist/commands/mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../../src/commands/mcp-tools.ts"],"names":[],"mappings":"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"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,5 @@
+import { Cli } from '@livestore/utils/node';
+export declare const mcpCommand: Cli.Command.Command<"mcp", never, never, {
+    readonly subcommand: import("effect/Option").Option<{}>;
+}>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAgB,MAAM,uBAAuB,CAAA;AA+FzD,eAAO,MAAM,UAAU;;EAAgF,CAAA"}