systemlink-cli 1.3.1__tar.gz → 1.4.1__tar.gz

{systemlink_cli-1.3.1 → systemlink_cli-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: systemlink-cli
-Version: 1.3.1
+Version: 1.4.1
 Summary: SystemLink Integrator CLI - cross-platform CLI for SystemLink workflows and templates.
 License-File: LICENSE
 Author: Fred Visser

{systemlink_cli-1.3.1 → systemlink_cli-1.4.1}/pyproject.toml

@@ -1,10 +1,14 @@
 [tool.poetry]
 name = "systemlink-cli"
-version = "1.3.1"
+version = "1.4.1"
 description = "SystemLink Integrator CLI - cross-platform CLI for SystemLink workflows and templates."
 authors = ["Fred Visser <fred.visser@emerson.com>"]
 packages = [{ include = "slcli" }]
-include = ["dff-editor/**/*", "slcli/skills/**/*"]
+include = [
+    { path = "dff-editor/index.html", format = ["wheel", "sdist"] },
+    { path = "dff-editor/editor.js", format = ["wheel", "sdist"] },
+    "slcli/skills/**/*",
+]
 
 
 [tool.poetry.scripts]

{systemlink_cli-1.3.1 → systemlink_cli-1.4.1}/slcli/_version.py

@@ -1,4 +1,4 @@
 """Version information for slcli."""
 
 # This file is auto-generated. Do not edit manually.
-__version__ = "1.3.1"
+__version__ = "1.4.1"

{systemlink_cli-1.3.1 → systemlink_cli-1.4.1}/slcli/skill_click.py

@@ -13,12 +13,11 @@ from .utils import ExitCodes
 SKILL_NAME = "slcli"
 SKILL_CHOICES = ["slcli", "systemlink-webapp"]
 
-# Mapping of client name → (personal skills dir, project subdir relative to repo root)
+# Mapping of client name -> (personal skills dir, project subdir relative to repo root)
 # personal dir uses Path.home() so it's always resolved at call time via _personal_dir().
 _CLIENT_TABLE: Dict[str, Tuple[str, str]] = {
-    "copilot": ("~/.copilot/skills", ".github/skills"),
+    "agents": ("~/.agents/skills", ".agents/skills"),
     "claude": ("~/.claude/skills", ".claude/skills"),
-    "codex": ("~/.agents/skills", ".agents/skills"),
 }
 
 CLIENT_CHOICES = list(_CLIENT_TABLE.keys())
@@ -84,6 +83,54 @@ def _find_bundled_skills_dir() -> Path:
     )
 
 
+# Universal project-scoped skills directory (client-agnostic)
+PROJECT_SKILLS_SUBDIR = ".agents/skills"
+
+
+def install_skills_to_directory(
+    directory: Path,
+    skill_names: Optional[List[str]] = None,
+    subdir: str = PROJECT_SKILLS_SUBDIR,
+) -> int:
+    """Install bundled skills into a project directory.
+
+    Copies skill folders into a skills subdirectory within *directory*.
+    The default location (``.agents/skills/``) is the universal convention
+    recognized by multiple AI clients.
+
+    Args:
+        directory: Project root to install into.
+        skill_names: Skills to install.  Defaults to all available skills.
+        subdir: Relative subdirectory for skills.  Defaults to ``.agents/skills``.
+
+    Returns:
+        Number of skills successfully installed.
+    """
+    if skill_names is None:
+        skill_names = list(SKILL_CHOICES)
+
+    try:
+        skills_dir = _find_bundled_skills_dir()
+    except FileNotFoundError:
+        return 0
+
+    dest_parent = directory / subdir
+    installed = 0
+
+    for name in skill_names:
+        source = skills_dir / name
+        if not source.exists():
+            continue
+        dest = dest_parent / name
+        dest_parent.mkdir(parents=True, exist_ok=True)
+        if dest.exists():
+            shutil.rmtree(dest)
+        shutil.copytree(source, dest)
+        installed += 1
+
+    return installed
+
+
 def _resolve_destinations(clients: List[str], scope: str) -> List[Path]:
     """Build the list of destination skill parent directories.
 
@@ -123,7 +170,7 @@ def register_skill_commands(cli: Any) -> None:
 
     @cli.group()
     def skill() -> None:
-        """Manage AI agent skills for Copilot, Claude, and Codex."""
+        """Manage AI agent skills for most agents and Claude."""
 
     @skill.command(name="install")
     @click.option(
@@ -136,9 +183,9 @@ def register_skill_commands(cli: Any) -> None:
     @click.option(
         "--client",
         "-c",
-        type=click.Choice(CLIENT_CHOICES + ["all"], case_sensitive=False),
+        type=click.Choice(CLIENT_CHOICES, case_sensitive=False),
         default=None,
-        help="AI client to install for (copilot, claude, codex, or all).",
+        help="AI client to install for (agents [most agents] or claude).",
     )
     @click.option(
         "--scope",
@@ -163,10 +210,10 @@ def register_skill_commands(cli: Any) -> None:
         Available skills: slcli, systemlink-webapp.
         Supported clients and their skill locations:
 
-        \b
-          copilot  personal: ~/.copilot/skills/       project: .github/skills/
-          claude   personal: ~/.claude/skills/         project: .claude/skills/
-          codex    personal: ~/.agents/skills/         project: .agents/skills/
+                    \b
+                agents   personal: ~/.agents/skills/         project: .agents/skills/
+                     (most agents)
+                claude   personal: ~/.claude/skills/         project: .claude/skills/
 
         When options are omitted you will be prompted interactively.
         """
@@ -183,8 +230,11 @@ def register_skill_commands(cli: Any) -> None:
         if client is None:
             client = questionary.select(
                 "Install for which AI client?",
-                choices=CLIENT_CHOICES + ["all"],
-                default="all",
+                choices=[
+                    questionary.Choice("most agents", value="agents"),
+                    questionary.Choice("claude", value="claude"),
+                ],
+                default="agents",
             ).ask()
             if client is None:
                 raise click.Abort()
@@ -200,7 +250,7 @@ def register_skill_commands(cli: Any) -> None:
 
         # ── resolve skill and client lists ────────────────────────────────────
         skill_names: List[str] = SKILL_CHOICES if skill == "all" else [skill]
-        clients: List[str] = CLIENT_CHOICES if client == "all" else [client]
+        clients: List[str] = [client]
 
         # ── locate source ─────────────────────────────────────────────────────
         try:

{systemlink_cli-1.3.1 → systemlink_cli-1.4.1}/slcli/skills/slcli/SKILL.md

@@ -676,7 +676,23 @@ slcli webapp open <WEBAPP_ID>                            # Open webapp URL in br
 
 Templates:
 - `html` (default) — minimal index.html
-- `angular` — Nimble Angular project with PROMPTS.md (AI-ready prompts) and README.md
+- `angular` — Nimble Angular project with `PROMPTS.md`, `README.md`, and bundled AI skills installed into `.agents/skills/`
+
+### skill — AI skill installation
+
+Install bundled skills for supported AI clients.
+
+```bash
+slcli skill install --skill [slcli|systemlink-webapp|all] --client [agents|claude] --scope [personal|project|both]
+```
+
+Client paths:
+- `agents` — personal: `~/.agents/skills/`, project: `.agents/skills/` (most agents)
+- `claude` — personal: `~/.claude/skills/`, project: `.claude/skills/`
+
+Notes:
+- `agents` is the default client in interactive mode.
+- `webapp init --template angular` installs project-scoped skills into `.agents/skills/` by default.
 
 ### example — Built-in example resource provisioning
 

{systemlink_cli-1.3.1 → systemlink_cli-1.4.1}/slcli/webapp_click.py

@@ -17,6 +17,7 @@ import questionary
 import requests
 
 from .cli_utils import validate_output_format
+from .skill_click import install_skills_to_directory
 from .universal_handlers import UniversalResponseHandler
 from .utils import (
     ExitCodes,
@@ -277,63 +278,59 @@ _ANGULAR_PROMPTS_MD = """\
 # SystemLink WebApp — AI Prompts
 
 This project was scaffolded with `slcli webapp init --template angular`.
+The **systemlink-webapp** skill has been installed into this project so
+your AI assistant already knows how to build Nimble Angular apps for
+SystemLink — including component choices, API patterns, routing, theming,
+and deployment. Just describe what you want.
 
-The **systemlink-webapp** skill teaches your AI assistant how to build
-Nimble Angular applications for SystemLink. Install it first:
+## Getting Started
 
-```bash
-slcli skill install --client all
-```
+Open this project in your editor and describe your app:
+
+> "I need a web dashboard for monitoring our production test systems.
+> It should show which systems are online, recent test results, and
+> any assets due for calibration."
 
-## Getting Started Prompts
+Your AI assistant will create the Angular project, install the right
+packages, and build the pages for you.
 
-Copy-paste these into your AI assistant to build out the project:
+## Example Prompts
 
-### 1. Create a basic dashboard layout
+Describe your goals — the skill handles the technical details.
 
-> "Set up the AppModule with NimbleModule imports, a nimble-theme-provider
-> with automatic theme detection, and a nimble-anchor-tabs layout with
-> Overview and Settings tabs. Use hash routing."
+### Fleet monitoring
 
-### 2. Add a systems overview page
+> "Build a dashboard that shows all connected systems with their
+> status, operating system, and last check-in time. Highlight any
+> systems that have been offline for more than 24 hours."
 
-> "Create a SystemsComponent that uses the Systems Management TypeScript
-> client to fetch connected systems and display them in a nimble-table
-> with columns for alias, state, OS, and last-updated timestamp.
-> Add a nimble-spinner while loading."
+### Test results review
 
-### 3. Add a test results page
+> "Create a page where I can browse recent test results, filter by
+> status (passed, failed, running) and program name, and see a
+> summary of failure rates."
 
-> "Create a TestResultsComponent that uses the Test Monitor TypeScript
-> client to list recent test results in a nimble-table. Add
-> nimble-select filters for status (Passed/Failed/Running) and
-> program name. Show a nimble-banner when there are failures."
+### Asset & calibration tracking
 
-### 4. Add an asset calibration tracker
+> "Show all tracked assets grouped by calibration status. I want to
+> see which assets are due soon, which are overdue, and be able to
+> click on an asset to see its full details."
 
-> "Create a CalibrationComponent that uses the Asset Management
-> TypeScript client to show assets grouped by calibration status.
-> Use nimble-card components for each status category with counts.
-> Add a nimble-drawer that shows asset details when clicked."
+### Production KPIs
 
-### 5. Build and deploy
+> "Build a dashboard with key metrics: first-pass yield, test
+> throughput per hour, and a trend chart of failures over the last
+> 30 days."
 
-> "Build the project for production and deploy it to SystemLink
-> using slcli webapp publish."
+### Build and deploy
+
+> "Build the project for production and deploy it to SystemLink."
 
 ## Reference
 
 - [Nimble Angular components](https://nimble.ni.dev/)
 - [SystemLink TypeScript clients](https://www.npmjs.com/package/@ni/systemlink-clients-ts)
 - [slcli webapp commands](https://ni-kismet.github.io/systemlink-cli/commands.html#webapp)
-
-## Build & Deploy
-
-```bash
-ng build --configuration production
-slcli webapp publish dist/<project-name>/browser/ \\
-  --name "My Dashboard" --workspace Default
-```
 """
 
 _ANGULAR_README_MD = """\
@@ -345,39 +342,23 @@ A Nimble Angular web application for SystemLink, scaffolded with
 ## Prerequisites
 
 - [Node.js](https://nodejs.org/) 18+ and npm
-- [Angular CLI](https://angular.dev/tools/cli) (`npm install -g @angular/cli`)
-- [slcli](https://ni-kismet.github.io/systemlink-cli/) with AI skills installed
+- [slcli](https://ni-kismet.github.io/systemlink-cli/)
 
-## Quick Start
+## Getting Started
 
-```bash
-# Install dependencies
-npm install
+Open this directory in your editor and ask your AI assistant to create
+the project — see [PROMPTS.md](PROMPTS.md) for ready-made prompts.
 
-# Start development server
-ng serve --open
-
-# Build for production
-ng build --configuration production
-```
+The AI skills for SystemLink webapp development are already installed
+in this project directory.
 
 ## Deploy to SystemLink
 
 ```bash
+ng build --configuration production
 slcli webapp publish dist/<project-name>/browser/ \\
   --name "My Dashboard" --workspace Default
 ```
-
-## AI-Assisted Development
-
-See [PROMPTS.md](PROMPTS.md) for example prompts to give your AI assistant.
-Install the systemlink-webapp skill first:
-
-```bash
-slcli skill install --client all
-```
-
-Then ask your assistant to build features using the prompts in PROMPTS.md.
 """
 
 
@@ -404,18 +385,19 @@ def _init_angular_template(directory: Path, force: bool) -> None:
     prompts_file.write_text(_ANGULAR_PROMPTS_MD, encoding="utf-8")
     readme_file.write_text(_ANGULAR_README_MD, encoding="utf-8")
 
+    # Auto-install AI skills into the project directory
+    installed = install_skills_to_directory(directory)
+    skill_msg = f"{installed} skill(s) installed" if installed else "skills not found"
+
     format_success(
         "Scaffolded Nimble Angular project",
         {
             "Directory": str(directory),
+            "Skills": skill_msg,
             "Next steps": (
                 "1. cd " + str(directory) + "\n"
-                "   2. ng new <app-name> --no-standalone\n"
-                "   3. cd <app-name>\n"
-                "   4. npm install @ni/nimble-angular "
-                "@ni/systemlink-clients-ts\n"
-                "   5. Install AI skills: slcli skill install --client all\n"
-                "   6. Open PROMPTS.md and start building with AI"
+                "   2. Open in your editor and ask AI to create the app\n"
+                "   3. See PROMPTS.md for example prompts"
             ),
         },
     )

systemlink_cli-1.3.1/dff-editor/README.md

@@ -1,182 +0,0 @@
-# Custom Fields Editor
-
-This directory contains a standalone web editor for SystemLink Custom Fields configurations with a VS Code-like interface.
-
-## Files
-
-- index.html - The main editor interface
-- editor.js - Editor JavaScript logic
-- README.md - This file
-- index.html.backup - Backup of original simple editor
-
-## Usage
-
-1. Start the editor server:
-
-```bash
-slcli customfield edit --port 8080
-```
-
-2. Open your browser to: http://localhost:8080
-
-3. Use the visual editor to build and manage your configuration
-
-4. Click "Apply to Server" when ready to save
-
-## Features
-
-### Monaco Editor
-
-- Syntax highlighting and IntelliSense for JSON
-- Real-time validation against custom fields schema
-- Auto-formatting (Alt+F) and validate (Alt+V)
-- Find/Replace (Ctrl+F / Ctrl+H)
-- Minimap, dark theme, format on paste/type
-- Auto-save every 30 seconds to local storage
-
-### Configuration Tree View
-
-- Root configuration, configurations, groups, fields
-- Counts for groups/fields; required field indicator
-- Click to navigate
-
-### Add New Items
-
-- Add Configuration: name, workspace, resource type, group keys
-- Add Group: key, name, display text, field keys (with duplicate key guard)
-- Add Field: key, name, display text, type, required (with duplicate key guard)
-- Templates with inline help and validation
-
-### Validation
-
-- JSON syntax correctness
-- Required fields present
-- Unique keys for groups/fields
-- Reference checks (configs → groups, groups → fields)
-- Enum validation (resourceType, fieldType)
-- Schema compliance
-
-### Server Integration
-
-- **Load from Server**: Fetch configurations by ID or list all configurations
-- **Apply to Server**: Seamlessly creates new or updates existing configurations
-  - **New configurations** (no ID): Automatically calls create endpoint and saves returned ID
-  - **Existing configurations** (has ID): Updates configuration on server
-  - Automatically detects operation type and uses appropriate endpoint
-- **Smart ID tracking**: After creating a config, the ID is saved to metadata and injected into the editor
-- Confirmation dialog before apply with operation-specific messaging
-- Error handling with clear messages
-- Metadata persistence: `.editor-metadata.json` tracks configuration IDs for seamless workflows
-
-### Keyboard Shortcuts
-
-- Alt+F: Format document
-- Alt+V: Validate document
-- Ctrl/Cmd+S: Save to server
-- Ctrl+F: Find
-- Ctrl+H: Find and replace
-
-### Persistence & Safety
-
-- Auto-save to localStorage every 30 seconds
-- Auto-recovery prompt for drafts <24h old
-- Unsaved changes warning on navigation
-- Download JSON export
-
-### Toolbar Actions
-
-- Format, Validate, Load Example, Download JSON, Reset
-
-## Configuration Structure
-
-### Configurations
-
-```json
-{
-  "name": "Work Order Configuration",
-  "workspace": "workspace-id",
-  "resourceType": "workorder:workorder",
-  "groupKeys": ["group1", "group2"],
-  "properties": {}
-}
-```
-
-Resource types: workorder:workorder, workitem:workitem, asset:asset, system:system, testmonitor:product
-
-Note: workorder:testplan has been replaced by workitem:workitem to align with the current API.
-
-### Groups
-
-```json
-{
-  "key": "basicInfo",
-  "workspace": "workspace-id",
-  "name": "Basic Information",
-  "displayText": "Basic Information",
-  "fieldKeys": ["field1", "field2"],
-  "properties": {}
-}
-```
-
-### Fields
-
-```json
-{
-  "key": "deviceId",
-  "workspace": "workspace-id",
-  "name": "Device ID",
-  "displayText": "Device Identifier",
-  "fieldType": "STRING",
-  "required": true,
-  "validation": { "maxLength": 50 },
-  "properties": {}
-}
-```
-
-Field types: STRING, NUMBER, BOOLEAN, DATE, DATETIME, SELECT, MULTISELECT
-Validation options: STRING (minLength, maxLength, pattern), NUMBER (min, max, step), DATE/DATETIME (min, max), SELECT/MULTISELECT (options)
-
-## Example Workflow
-
-1. Load example or start empty
-2. Add configuration (resource type)
-3. Add groups
-4. Add fields
-5. Link fields to groups via fieldKeys
-6. Link groups to configuration via groupKeys
-7. Validate
-8. Apply to server (automatically creates new or updates existing configuration)
-9. Configuration ID is saved automatically for future updates
-
-## Technical Details
-
-- Monaco Editor 0.45.0 via CDN
-- Pure vanilla JS; no build step
-- Uses fetch for API calls; localStorage for drafts
-- Customize `serverUrl`, schema, and templates in editor.js
-- Smart create/update detection based on configuration ID presence
-- Metadata tracking in `.editor-metadata.json` for seamless workflows
-
-## Troubleshooting
-
-- Editor not loading: check console/CDN access
-- Validation errors: ensure unique keys and valid references
-- Server issues: check port, CORS, network tab
-- Auto-save: ensure localStorage is available
-
-## Future Enhancements
-
-- Drag-and-drop reordering
-- Visual preview
-- Diff view (local vs server)
-- Undo/redo history
-- Import from file
-- Field/group duplication
-- Bulk operations
-- Search/filter in tree
-- Theme toggle
-- Version history
-
----
-
-Version: 2.1 | Updated: January 8, 2026