@isl-lang/cli - npm Package Compare versions

Comparing version 0.0.1 to 0.1.0

dist/index.d.cts

+#!/usr/bin/env node

dist/index.d.ts

+#!/usr/bin/env node

LICENSE

+MIT License
+
+Copyright (c) 2024 ISL Lang
+
+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.

README.md

+# @isl-lang/cli
+
+Command-line interface for ISL (Intent Specification Language).
+
+## Installation
+
+```bash
+# Global installation (recommended)
+npm install -g @isl-lang/cli
+
+# Or use npx
+npx @isl-lang/cli <command>
+```
+
+## Quick Start
+
+```bash
+# Initialize a new ISL project
+isl init my-project
+
+# Parse and validate ISL files
+isl check specs/*.isl
+
+# Generate code
+isl generate --target typescript specs/
+
+# Start the REPL
+isl repl
+
+# Get help
+isl --help
+```
+
+## Commands
+
+### `isl init [name]`
+
+Initialize a new ISL project with recommended structure.
+
+```bash
+isl init my-api
+cd my-api
+```
+
+Creates:
+- `isl.config.yaml` - Project configuration
+- `specs/` - Directory for ISL specifications
+- `generated/` - Output directory for generated code
+
+### `isl check <files...>`
+
+Parse and type-check ISL files.
+
+```bash
+isl check specs/*.isl
+isl check --strict specs/
+```
+
+Options:
+- `--strict` - Enable strict mode (all warnings become errors)
+- `--format <format>` - Output format (text, json, sarif)
+
+### `isl generate <files...>`
+
+Generate code from ISL specifications.
+
+```bash
+# Generate TypeScript
+isl generate --target typescript specs/
+
+# Generate Python
+isl generate --target python --output src/generated specs/
+
+# Generate OpenAPI
+isl generate --target openapi specs/api.isl
+```
+
+Options:
+- `--target, -t` - Target language (typescript, python, rust, go, openapi, graphql)
+- `--output, -o` - Output directory
+- `--config, -c` - Config file path
+
+### `isl verify <files...>`
+
+Formally verify ISL specifications.
+
+```bash
+isl verify specs/critical-flow.isl
+```
+
+### `isl repl`
+
+Start an interactive REPL for exploring ISL.
+
+```bash
+isl repl
+```
+
+### `isl format <files...>`
+
+Format ISL files.
+
+```bash
+isl format specs/*.isl --write
+```
+
+### `isl lsp`
+
+Start the Language Server Protocol server.
+
+```bash
+isl lsp --stdio
+```
+
+## Configuration
+
+Create `isl.config.yaml` in your project root:
+
+```yaml
+version: 1
+
+# Default generation target
+target: typescript
+
+# Output directory
+output: ./generated
+
+# Include paths for imports
+include:
+  - ./specs
+  - ./node_modules/@company/shared-specs
+
+# Generation options
+codegen:
+  typescript:
+    runtime: true
+    validators: true
+  python:
+    framework: fastapi
+    pydantic: v2
+```
+
+## Environment Variables
+
+- `ISL_CONFIG` - Path to config file
+- `ISL_DEBUG` - Enable debug output
+- `ISL_NO_COLOR` - Disable colored output
+
+## Documentation
+
+Full documentation: https://isl-lang.dev/docs/cli
+
+## Related Packages
+
+- [@isl-lang/parser](https://npm.im/@isl-lang/parser) - ISL parser
+- [@isl-lang/codegen](https://npm.im/@isl-lang/codegen) - Code generators
+- [@isl-lang/repl](https://npm.im/@isl-lang/repl) - Interactive REPL
+
+## License
+
+MIT

templates/init/isl.config.yaml

+# ISL Configuration
+# Documentation: https://intentos.dev/docs/config
+
+version: "1.0"
+name: {{name}}
+
+# ISL source files
+include:
+  - src/**/*.isl
+
+# Files to exclude
+exclude:
+  - node_modules/**
+  - dist/**
+  - generated/**
+
+# Output configuration
+output:
+  dir: ./generated
+  types: true
+  tests: true
+  docs: false
+
+# AI generation settings
+ai:
+  model: claude-sonnet-4-20250514
+  apiKey: ${ANTHROPIC_API_KEY}
+
+# Verification settings
+verify:
+  timeout: 30000
+  minTrustScore: 70

package.json

 {
   "name": "@isl-lang/cli",
-  "version": "0.0.1",
-  "description": "ISL (Intent Specification Language) - CLI tool",
-  "main": "index.js",
-  "keywords": ["isl", "intent-specification-language", "cli"],
-  "author": "guardiavault-oss",
+  "version": "0.1.0",
+  "description": "Command-line interface for ISL (Intent Specification Language)",
+  "author": "ISL Team",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/guardiavault-oss/ISL-LANG.git"
+    "url": "https://github.com/isl-lang/isl.git",
+    "directory": "packages/cli"
   },
-  "homepage": "https://github.com/guardiavault-oss/ISL-LANG"
+  "homepage": "https://isl-lang.dev/docs/cli",
+  "bugs": {
+    "url": "https://github.com/isl-lang/isl/issues"
+  },
+  "keywords": [
+    "isl",
+    "intent-specification-language",
+    "cli",
+    "ai",
+    "verification",
+    "code-generation"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module",
+  "bin": {
+    "isl": "./dist/index.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@isl-lang/parser": "workspace:*",
+    "@isl-lang/typechecker": "workspace:*",
+    "@isl-lang/evaluator": "workspace:*",
+    "@isl-lang/repl": "workspace:*",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "ora": "^8.0.1",
+    "yaml": "^2.3.4",
+    "glob": "^10.3.10"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  }
 }

index.js

-// @isl-lang/cli - Placeholder package
-// Full implementation coming soon
-// See: https://github.com/guardiavault-oss/ISL-LANG
-console.log('ISL CLI - coming soon');

New alerts

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

Environment variable access

Supply chain risk

Package accesses environment variables, which may be a sign of credential stuffing or data theft.

Found 8 instances in 1 package

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 1 instance in 1 package

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

No website

Quality

Package does not have a website.

Found 1 instance in 1 package

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Fixed alerts

No README

Quality

Package does not have a README. This may indicate a failed publish or a low quality package.

Found 1 instance in 1 package

Trivial Package

Supply chain risk

Packages less than 10 lines of code are easily copied into your own project and may not warrant the additional supply chain risk of an external dependency.

Found 1 instance in 1 package

No bug tracker

Maintenance

Package does not have a linked bug tracker in package.json.

Found 1 instance in 1 package

No website

Quality

Package does not have a website.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

966736

158641.54%

Number of package files

13

550%

Lines of code

7385

184525%

Number of medium quality alerts

0

-100%

Number of lines in readme file

162

Infinity%

Is type module

Yes

NaN

Worsened metrics

Dependency count

9

Infinity%

Dev dependency count

5

Infinity%

Number of low supply chain risk alerts

23

Infinity%

Dependency changes

• + Added

  @isl-lang/evaluator@workspace:*

• + Added

  @isl-lang/parser@workspace:*

• + Added

  @isl-lang/repl@workspace:*

• + Added

  @isl-lang/typechecker@workspace:*

• + Added

  chalk@^5.3.0

• + Added

  commander@^12.0.0

• + Added

  glob@^10.3.10

• + Added

  ora@^8.0.1

• + Added

  yaml@^2.3.4

• + Added

  @isaacs/cliui@8.0.2
  (transitive)

• + Added

  @pkgjs/parseargs@0.11.0
  (transitive)

• + Added

  ansi-regex@5.0.16.2.2
  (transitive)

• + Added

  ansi-styles@4.3.06.2.3
  (transitive)

• + Added

  balanced-match@1.0.2
  (transitive)

• + Added

  brace-expansion@2.1.1
  (transitive)

• + Added

  chalk@5.6.2
  (transitive)

• + Added

  cli-cursor@5.0.0
  (transitive)

• + Added

  cli-spinners@2.9.2
  (transitive)

• + Added

  color-convert@2.0.1
  (transitive)

• + Added

  color-name@1.1.4
  (transitive)

• + Added

  commander@12.1.0
  (transitive)

• + Added

  cross-spawn@7.0.6
  (transitive)

• + Added

  eastasianwidth@0.2.0
  (transitive)

• + Added

  emoji-regex@10.6.08.0.09.2.2
  (transitive)

• + Added

  foreground-child@3.3.1
  (transitive)

• + Added

  get-east-asian-width@1.6.0
  (transitive)

• + Added

  glob@10.5.0
  (transitive)

• + Added

  is-fullwidth-code-point@3.0.0
  (transitive)

• + Added

  is-interactive@2.0.0
  (transitive)

• + Added

  is-unicode-supported@1.3.02.1.0
  (transitive)

• + Added

  isexe@2.0.0
  (transitive)

• + Added

  jackspeak@3.4.3
  (transitive)

• + Added

  log-symbols@6.0.0
  (transitive)

• + Added

  lru-cache@10.4.3
  (transitive)

• + Added

  mimic-function@5.0.1
  (transitive)

• + Added

  minimatch@9.0.9
  (transitive)

• + Added

  minipass@7.1.3
  (transitive)

• + Added

  onetime@7.0.0
  (transitive)

• + Added

  ora@8.2.0
  (transitive)

• + Added

  package-json-from-dist@1.0.1
  (transitive)

• + Added

  path-key@3.1.1
  (transitive)

• + Added

  path-scurry@1.11.1
  (transitive)

• + Added

  restore-cursor@5.1.0
  (transitive)

• + Added

  shebang-command@2.0.0
  (transitive)

• + Added

  shebang-regex@3.0.0
  (transitive)

• + Added

  signal-exit@4.1.0
  (transitive)

• + Added

  stdin-discarder@0.2.2
  (transitive)

• + Added

  string-width@4.2.35.1.27.2.0
  (transitive)

• + Added

  strip-ansi@6.0.17.2.0
  (transitive)

• + Added

  which@2.0.2
  (transitive)

• + Added

  wrap-ansi@7.0.08.1.0
  (transitive)

• + Added

  yaml@2.9.0
  (transitive)