@symplek/cli 0.0.0-stage → 0.2.0-beta.0

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+## 0.2.0-beta.0
+
+### Minor Changes
+
+- 91ca43f: First public beta of the CLI. Its `create` wrapper is versioned alongside it and held back from npm.
+
+  **@symplek/cli**
+  - The code generators emit TypeScript that compiles against the real `@symplek/core` API. A compile gate in the test suite type-checks every generator path.
+  - Requires Node `>=20.19`, the lowest version the package can start on.
+  - `@symplek/core` is declared as a peer dependency, since generated code imports it.
+  - `symplek init` no longer hangs while the package manager installs.
+  - The binary resolves on case-sensitive filesystems (`symplek`, lowercase).
+  - `symplek --version` reports the real package version.
+  - The default project name is `my-symplek-project`, which passes the CLI's own name check in `--yes` mode.
+  - YAML generation validates its inputs and escapes template values.
+  - Every agent file the CLI scaffolds passes the CLI's own `validate` and `generate`. The templates used keys the validator rejected.
+  - `validate` and `generate` accept any well-formed model id. The CLI no longer keeps its own list of which models exist, so a model released after the CLI still works.
+  - `symplek add agent --type` is checked against the real list of types. The `typescript` type writes a TypeScript agent and no YAML file; it used to write TypeScript into the YAML file.
+  - The test `symplek add agent` writes into your project runs your real agent and replaces only the model call. The old one mocked the agent and tested the mock.
+  - Scaffolded projects depend on `zod` and on the CLI that created them, so `symplek generate` runs from inside the project.
+
+  **create-symplek**
+  - New package, not published in this release. The name `create-weft` belongs to someone else on npm, so the package is named `create-symplek` and stays marked private until a publishing decision is made.
+  - A thin wrapper that runs `symplek init` from the `@symplek/cli` it depends on, started with the running Node binary and no shell, so it behaves the same on Windows, macOS and Linux. Its version is linked to `@symplek/cli`'s, so the two are bumped to the same number whenever they are released together.
+
+### Patch Changes
+
+- Updated dependencies [91ca43f]
+  - @symplek/core@1.0.0-beta.2
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-XX-XX
+
+### Added
+
+- Initial release. `weft init` scaffolds minimal, standard, and full project templates.
+
+[Unreleased]: https://github.com/wefthq/weft/compare/weft-cli@0.1.0...HEAD
+[0.1.0]: https://github.com/wefthq/weft/releases/tag/weft-cli@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Symplek Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# @symplek/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Symplek CLI - AI Agent Development Toolkit
+
+## Installation
+
+```bash
+# Global install
+npm install -g @symplek/cli
+
+# Or use npx
+npx @symplek/cli --help
+```
+
+## Usage
+
+```bash
+# Display help
+symplek --help
+
+# Display version
+symplek --version
+
+# Initialize a new Symplek project
+symplek init
+
+# Add agents, tools, or workflows
+symplek add agent my-agent
+
+# Validate YAML agent definitions
+symplek validate agents/
+
+# Migrate existing agent definitions
+symplek migrate
+
+# Generate TypeScript from YAML
+symplek generate
+```
+
+## Commands
+
+| Command | Description | Status |
+|---------|-------------|--------|
+| `symplek --help` | Display help information | ✅ Available |
+| `symplek --version` | Display CLI version | ✅ Available |
+| `symplek init` | Initialize a new Symplek project | ✅ Available |
+| `symplek add` | Add agents, tools, or workflows | ✅ Available |
+| `symplek validate` | Validate YAML definitions | ✅ Available |
+| `symplek migrate` | Migrate existing agent definitions | ✅ Available |
+| `symplek generate` | Generate TypeScript from YAML | ✅ Available |
+
+## Requirements
+
+- Node.js >= 20.19
+- npm, pnpm, yarn, or bun
+
+## Development
+
+```bash
+# Build the CLI
+pnpm build
+
+# Watch mode
+pnpm dev
+
+# Run tests
+pnpm test
+
+# Type check
+pnpm typecheck
+```
+
+## License
+
+MIT

package/bin/symplek.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// ⚠️ FATAL #5 FIX (2026-07-07): CLI split from library entry.
+// dist/cli.js calls program.parse() — safe because it's only loaded via bin.
+// dist/index.js is library-only — safe for programmatic imports.
+require("../dist/cli.js");

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/cli.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @fileoverview CLI entry point for @symplek/cli.
+ * @description This file IS the executable (`bin` in package.json).
+ *   It calls program.parse() — it should NEVER be imported as a library.
+ *
+ * ⚠️ CRITICAL: This file calls process.exit(). Do NOT import it.
+ *   For programmatic use, import from "@symplek/cli" which provides only
+ *   the library exports (no side effects, no process.exit).
+ *
+ * @module @symplek/cli/cli
+ * @since 1.0.0-beta.2 — Split from index.ts (FATAL #5 fix, 2026-07-07)
+ */
+const commander_1 = require("commander");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version } = require("../package.json");
+const program = new commander_1.Command();
+program
+    .name("symplek")
+    .description("Symplek CLI - AI Agent Development Toolkit")
+    .version(version)
+    .showHelpAfterError(true)
+    .showSuggestionAfterError(true);
+const add_js_1 = require("./commands/add.js");
+const generate_js_1 = require("./commands/generate.js");
+const init_js_1 = require("./commands/init.js");
+const migrate_js_1 = require("./commands/migrate.js");
+const validate_js_1 = require("./commands/validate.js");
+program.addCommand((0, init_js_1.initCommand)());
+program.addCommand((0, add_js_1.createAddCommand)());
+program.addCommand((0, validate_js_1.validateCommand)());
+program.addCommand((0, migrate_js_1.migrateCommand)());
+program.addCommand((0, generate_js_1.generateCommand)());
+// Handle unknown commands
+program.on("command:*", (operands) => {
+    console.error(`error: unknown command '${operands[0]}'`);
+    console.error();
+    program.outputHelp();
+    process.exit(1);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA;;;;;;;;;;;GAWG;AACH,yCAAoC;AAEpC,iEAAiE;AACjE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,4CAA4C,CAAC;KACzD,OAAO,CAAC,OAAO,CAAC;KAChB,kBAAkB,CAAC,IAAI,CAAC;KACxB,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAElC,8CAAqD;AACrD,wDAAyD;AACzD,gDAAiD;AACjD,sDAAuD;AACvD,wDAAyD;AAEzD,OAAO,CAAC,UAAU,CAAC,IAAA,qBAAW,GAAE,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,IAAA,yBAAgB,GAAE,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,IAAA,6BAAe,GAAE,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,IAAA,2BAAc,GAAE,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,IAAA,6BAAe,GAAE,CAAC,CAAC;AAEtC,0BAA0B;AAC1B,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE;IACnC,OAAO,CAAC,KAAK,CAAC,2BAA2B,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,OAAO,CAAC,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/add.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `symplek add` command - scaffolds new components
+ * Supports: agent (more types coming in future stories)
+ */
+import { Command } from "commander";
+import { type AgentType } from "../utils/templates.js";
+export { kebabToCamel } from "../naming.js";
+/**
+ * True when `name` can be used as an agent name: kebab-case, and not a word
+ * that would make the exported function unparseable.
+ */
+export declare function validateAgentName(name: string): boolean;
+/**
+ * Generate YAML content for an agent
+ */
+export declare function generateAgentYaml(name: string, options: {
+    type: AgentType | "custom";
+    model: string;
+    tools?: string[];
+}): string;
+/**
+ * Generate TypeScript content for an agent
+ */
+export declare function generateAgentTypeScript(name: string, options: {
+    model: string;
+    tools?: string[];
+}): string;
+/**
+ * Generate test file content for an agent
+ */
+export declare function generateAgentTest(name: string): string;
+/**
+ * Create the add command with subcommands
+ */
+export declare function createAddCommand(): Command;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,uBAAuB,CAAC;AAsC/B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAiBD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GACA,MAAM,CAiDR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GACA,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+CtD;AAmFD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CA0R1C"}