@amaster.ai/cli 1.1.35 → 1.1.37
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/dist/cli.cjs +230 -4
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.js +231 -5
- package/dist/cli.js.map +1 -1
- package/package.json +1 -1
package/dist/cli.js
CHANGED
|
@@ -4,14 +4,14 @@ import { createInterface } from 'readline/promises';
|
|
|
4
4
|
import { stdin, stdout } from 'process';
|
|
5
5
|
import { Command, Option } from 'commander';
|
|
6
6
|
import { readFile, mkdtemp, stat, rm, writeFile, readdir, access, unlink, copyFile, mkdir } from 'fs/promises';
|
|
7
|
-
import { join, resolve, basename, dirname, relative, parse, extname } from 'path';
|
|
7
|
+
import { join, resolve, basename, dirname, relative, parse, extname, isAbsolute } from 'path';
|
|
8
8
|
import { randomBytes, createHash, randomUUID } from 'crypto';
|
|
9
9
|
import { tmpdir, homedir } from 'os';
|
|
10
10
|
import * as tar from 'tar';
|
|
11
11
|
import { createServer } from 'http';
|
|
12
12
|
import { execFile, spawn, spawnSync } from 'child_process';
|
|
13
|
+
import YAML2, { parse as parse$1 } from 'yaml';
|
|
13
14
|
import { promisify } from 'util';
|
|
14
|
-
import YAML2 from 'yaml';
|
|
15
15
|
import ts from 'typescript';
|
|
16
16
|
|
|
17
17
|
var EXCLUDED_NAMES = /* @__PURE__ */ new Set([".git", "node_modules", ".DS_Store", "PROMPT.md"]);
|
|
@@ -51,6 +51,7 @@ async function packageAddonDirectory(sourceDir) {
|
|
|
51
51
|
cwd: absoluteSourceDir,
|
|
52
52
|
gzip: true,
|
|
53
53
|
file: archivePath,
|
|
54
|
+
noMtime: true,
|
|
54
55
|
portable: true
|
|
55
56
|
},
|
|
56
57
|
files
|
|
@@ -532,12 +533,33 @@ async function getCurrentUser(registry) {
|
|
|
532
533
|
function logout(registry) {
|
|
533
534
|
clearStoredSession(registry);
|
|
534
535
|
}
|
|
536
|
+
var SKILL_RESOURCE_MAX_FILE_SIZE_BYTES = 1024 * 1024;
|
|
537
|
+
var SKILL_REFERENCE_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".mdx", ".txt", ".json", ".yml", ".yaml", ".ts", ".tsx", ".js", ".mjs"]);
|
|
538
|
+
var SKILL_ASSET_EXTENSIONS = /* @__PURE__ */ new Set([
|
|
539
|
+
...SKILL_REFERENCE_EXTENSIONS,
|
|
540
|
+
".bpmn",
|
|
541
|
+
".csv",
|
|
542
|
+
".html",
|
|
543
|
+
".jsonl",
|
|
544
|
+
".toml",
|
|
545
|
+
".xml",
|
|
546
|
+
".css",
|
|
547
|
+
".scss",
|
|
548
|
+
".svg",
|
|
549
|
+
".png",
|
|
550
|
+
".jpg",
|
|
551
|
+
".jpeg",
|
|
552
|
+
".webp"
|
|
553
|
+
]);
|
|
554
|
+
var SKILL_SCRIPT_EXTENSIONS = /* @__PURE__ */ new Set([".sh", ".ts", ".tsx", ".js", ".mjs", ".cjs"]);
|
|
555
|
+
var SKILL_SCRIPT_RESOURCE_EXTENSIONS = /* @__PURE__ */ new Set([...SKILL_ASSET_EXTENSIONS, ...SKILL_SCRIPT_EXTENSIONS]);
|
|
535
556
|
async function loadAddonManifestFromDirectory(directory) {
|
|
536
557
|
const manifestPath = join(directory, "addon.json");
|
|
537
558
|
const manifestText = await readFile(manifestPath, "utf8");
|
|
538
559
|
const manifest = JSON.parse(manifestText);
|
|
539
560
|
validateAddonManifest(manifest);
|
|
540
561
|
await assertDisplayAssetPathsExist(directory, manifest);
|
|
562
|
+
await assertSkillMemberContracts(directory, manifest);
|
|
541
563
|
return manifest;
|
|
542
564
|
}
|
|
543
565
|
function validateAddonManifest(manifest) {
|
|
@@ -557,9 +579,27 @@ function validateAddonManifest(manifest) {
|
|
|
557
579
|
throw new Error("addon.json missing members");
|
|
558
580
|
}
|
|
559
581
|
validateDisplayAssets(manifest);
|
|
582
|
+
validateMembers(manifest);
|
|
560
583
|
validateInstallRequirements(manifest);
|
|
561
584
|
validateInstallNpm(manifest);
|
|
562
585
|
}
|
|
586
|
+
function validateMembers(manifest) {
|
|
587
|
+
const allowedTypes = /* @__PURE__ */ new Set(["component", "page", "function", "skill", "theme", "settings", "workflow", "bpmn", "entity", "datasource"]);
|
|
588
|
+
for (const member of manifest.members) {
|
|
589
|
+
if (!member.name || typeof member.name !== "string") {
|
|
590
|
+
throw new Error("addon.json member missing name");
|
|
591
|
+
}
|
|
592
|
+
if (!member.type || typeof member.type !== "string") {
|
|
593
|
+
throw new Error(`addon.json member ${member.name} missing type`);
|
|
594
|
+
}
|
|
595
|
+
if (!allowedTypes.has(member.type)) {
|
|
596
|
+
throw new Error(`Unsupported addon member type: ${member.type}`);
|
|
597
|
+
}
|
|
598
|
+
if (!resolveMemberSourcePath(member)) {
|
|
599
|
+
throw new Error(`addon.json member ${member.name} missing source.path`);
|
|
600
|
+
}
|
|
601
|
+
}
|
|
602
|
+
}
|
|
563
603
|
function validateDisplayAssets(manifest) {
|
|
564
604
|
const image = manifest.display.image;
|
|
565
605
|
if (image !== void 0) {
|
|
@@ -590,6 +630,128 @@ async function assertDisplayAssetPathsExist(directory, manifest) {
|
|
|
590
630
|
await assertPathExists(directory, normalizeRelativePath(assetPath, "display asset path"));
|
|
591
631
|
}
|
|
592
632
|
}
|
|
633
|
+
async function assertSkillMemberContracts(directory, manifest) {
|
|
634
|
+
for (const member of manifest.members) {
|
|
635
|
+
if (member.type !== "skill") {
|
|
636
|
+
continue;
|
|
637
|
+
}
|
|
638
|
+
const sourcePath = resolveMemberSourcePath(member);
|
|
639
|
+
if (!sourcePath) {
|
|
640
|
+
throw new Error(`Skill member ${member.name} is missing source.path`);
|
|
641
|
+
}
|
|
642
|
+
const sourceStat = await stat(join(directory, sourcePath));
|
|
643
|
+
if (!sourceStat.isDirectory()) {
|
|
644
|
+
throw new Error(`Skill member ${member.name} source.path must be a directory`);
|
|
645
|
+
}
|
|
646
|
+
await assertSkillMarkdown(directory, member, sourcePath);
|
|
647
|
+
await assertOptionalSkillResourceDirectory(directory, member, sourcePath, "references", SKILL_REFERENCE_EXTENSIONS);
|
|
648
|
+
await assertOptionalSkillResourceDirectory(directory, member, sourcePath, "assets", SKILL_ASSET_EXTENSIONS);
|
|
649
|
+
await assertSkillScripts(directory, member, sourcePath);
|
|
650
|
+
}
|
|
651
|
+
}
|
|
652
|
+
async function assertSkillMarkdown(directory, member, sourcePath) {
|
|
653
|
+
const skillPath = join(sourcePath, "SKILL.md");
|
|
654
|
+
await assertPathExists(directory, skillPath);
|
|
655
|
+
const content = await readFile(join(directory, skillPath), "utf8");
|
|
656
|
+
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
|
|
657
|
+
if (!match) {
|
|
658
|
+
throw new Error(`Skill member ${member.name} SKILL.md missing YAML frontmatter`);
|
|
659
|
+
}
|
|
660
|
+
let frontmatter;
|
|
661
|
+
try {
|
|
662
|
+
frontmatter = parse$1(match[1] ?? "");
|
|
663
|
+
} catch (error) {
|
|
664
|
+
throw new Error(`Skill member ${member.name} SKILL.md frontmatter is invalid YAML: ${error instanceof Error ? error.message : String(error)}`);
|
|
665
|
+
}
|
|
666
|
+
if (!frontmatter || typeof frontmatter !== "object" || Array.isArray(frontmatter)) {
|
|
667
|
+
throw new Error(`Skill member ${member.name} SKILL.md frontmatter must be a YAML object`);
|
|
668
|
+
}
|
|
669
|
+
const record = frontmatter;
|
|
670
|
+
if (typeof record.name !== "string" || !record.name.trim()) {
|
|
671
|
+
throw new Error(`Skill member ${member.name} SKILL.md frontmatter missing name`);
|
|
672
|
+
}
|
|
673
|
+
if (!/^[a-z0-9-]+$/.test(record.name.trim())) {
|
|
674
|
+
throw new Error(`Skill member ${member.name} SKILL.md frontmatter name must be hyphen-case`);
|
|
675
|
+
}
|
|
676
|
+
if (typeof record.description !== "string" || !record.description.trim()) {
|
|
677
|
+
throw new Error(`Skill member ${member.name} SKILL.md frontmatter missing description`);
|
|
678
|
+
}
|
|
679
|
+
}
|
|
680
|
+
async function assertOptionalSkillResourceDirectory(directory, member, sourcePath, directoryName, allowedExtensions) {
|
|
681
|
+
const relativePath = join(sourcePath, directoryName);
|
|
682
|
+
if (!await pathExists(directory, relativePath)) {
|
|
683
|
+
return;
|
|
684
|
+
}
|
|
685
|
+
const resourceStat = await stat(join(directory, relativePath));
|
|
686
|
+
if (!resourceStat.isDirectory()) {
|
|
687
|
+
throw new Error(`Skill member ${member.name} ${directoryName}/ must be a directory`);
|
|
688
|
+
}
|
|
689
|
+
for (const file of await collectRelativeFiles(directory, relativePath)) {
|
|
690
|
+
if (!allowedExtensions.has(extname(file).toLowerCase())) {
|
|
691
|
+
throw new Error(`Skill member ${member.name} has unsupported ${directoryName} file type: ${file}`);
|
|
692
|
+
}
|
|
693
|
+
const fileStat = await stat(join(directory, file));
|
|
694
|
+
if (fileStat.size > SKILL_RESOURCE_MAX_FILE_SIZE_BYTES) {
|
|
695
|
+
throw new Error(`Skill member ${member.name} ${directoryName} file is too large: ${file}`);
|
|
696
|
+
}
|
|
697
|
+
}
|
|
698
|
+
}
|
|
699
|
+
async function assertSkillScripts(directory, member, sourcePath) {
|
|
700
|
+
const scriptsPath = join(sourcePath, "scripts");
|
|
701
|
+
if (!await pathExists(directory, scriptsPath)) {
|
|
702
|
+
return;
|
|
703
|
+
}
|
|
704
|
+
const scriptsStat = await stat(join(directory, scriptsPath));
|
|
705
|
+
if (!scriptsStat.isDirectory()) {
|
|
706
|
+
throw new Error(`Skill member ${member.name} scripts/ must be a directory`);
|
|
707
|
+
}
|
|
708
|
+
await assertSkillResourceFiles(directory, member, scriptsPath, "scripts", SKILL_SCRIPT_RESOURCE_EXTENSIONS);
|
|
709
|
+
const manifestPath = join(scriptsPath, "scripts.json");
|
|
710
|
+
await assertPathExists(directory, manifestPath);
|
|
711
|
+
const scriptsManifest = JSON.parse(await readFile(join(directory, manifestPath), "utf8"));
|
|
712
|
+
if (!scriptsManifest || typeof scriptsManifest !== "object" || Array.isArray(scriptsManifest)) {
|
|
713
|
+
throw new Error(`Skill member ${member.name} scripts.json must contain a JSON object`);
|
|
714
|
+
}
|
|
715
|
+
const scripts = scriptsManifest.scripts;
|
|
716
|
+
if (!Array.isArray(scripts)) {
|
|
717
|
+
throw new Error(`Skill member ${member.name} scripts.json missing scripts array`);
|
|
718
|
+
}
|
|
719
|
+
if (!scripts.length) {
|
|
720
|
+
throw new Error(`Skill member ${member.name} scripts.json must declare at least one script entrypoint`);
|
|
721
|
+
}
|
|
722
|
+
const declaredPaths = /* @__PURE__ */ new Set();
|
|
723
|
+
for (const script of scripts) {
|
|
724
|
+
if (!script || typeof script !== "object" || Array.isArray(script)) {
|
|
725
|
+
throw new Error(`Skill member ${member.name} scripts.json contains an invalid script entry`);
|
|
726
|
+
}
|
|
727
|
+
const scriptRecord = script;
|
|
728
|
+
if (typeof scriptRecord.name !== "string" || !scriptRecord.name.trim()) {
|
|
729
|
+
throw new Error(`Skill member ${member.name} scripts.json script missing name`);
|
|
730
|
+
}
|
|
731
|
+
if (typeof scriptRecord.path !== "string" || !scriptRecord.path.trim()) {
|
|
732
|
+
throw new Error(`Skill member ${member.name} scripts.json script ${scriptRecord.name} missing path`);
|
|
733
|
+
}
|
|
734
|
+
if (typeof scriptRecord.description !== "string" || !scriptRecord.description.trim()) {
|
|
735
|
+
throw new Error(`Skill member ${member.name} scripts.json script ${scriptRecord.name} missing description`);
|
|
736
|
+
}
|
|
737
|
+
if (typeof scriptRecord.requiresConfirmation !== "boolean") {
|
|
738
|
+
throw new Error(`Skill member ${member.name} scripts.json script ${scriptRecord.name} missing requiresConfirmation`);
|
|
739
|
+
}
|
|
740
|
+
if (typeof scriptRecord.writesProjectFiles !== "boolean") {
|
|
741
|
+
throw new Error(`Skill member ${member.name} scripts.json script ${scriptRecord.name} missing writesProjectFiles`);
|
|
742
|
+
}
|
|
743
|
+
const scriptPath = normalizeSkillScriptPath(scriptRecord.path, member.name);
|
|
744
|
+
if (!SKILL_SCRIPT_EXTENSIONS.has(extname(scriptPath).toLowerCase())) {
|
|
745
|
+
throw new Error(`Skill member ${member.name} has unsupported script file type: ${scriptPath}`);
|
|
746
|
+
}
|
|
747
|
+
await assertPathExists(directory, join(scriptsPath, scriptPath));
|
|
748
|
+
const normalizedScriptPath = join(scriptsPath, scriptPath).replace(/\\/g, "/");
|
|
749
|
+
if (declaredPaths.has(normalizedScriptPath)) {
|
|
750
|
+
throw new Error(`Skill member ${member.name} scripts.json declares duplicate script path: ${scriptPath}`);
|
|
751
|
+
}
|
|
752
|
+
declaredPaths.add(normalizedScriptPath);
|
|
753
|
+
}
|
|
754
|
+
}
|
|
593
755
|
function validateInstallRequirements(manifest) {
|
|
594
756
|
const requirements = manifest.install?.requirements;
|
|
595
757
|
if (!requirements) {
|
|
@@ -668,15 +830,63 @@ function resolveMemberSourcePath(member) {
|
|
|
668
830
|
return null;
|
|
669
831
|
}
|
|
670
832
|
function normalizeRelativePath(value, fieldName = "path") {
|
|
833
|
+
if (isAbsolute(value)) {
|
|
834
|
+
throw new Error(`Invalid addon.json ${fieldName}: ${value}`);
|
|
835
|
+
}
|
|
671
836
|
const normalized = value.replace(/^\.?\//, "").replace(/\\/g, "/");
|
|
672
837
|
if (!normalized || normalized.startsWith("../") || normalized.includes("/../")) {
|
|
673
838
|
throw new Error(`Invalid addon.json ${fieldName}: ${value}`);
|
|
674
839
|
}
|
|
675
840
|
return normalized;
|
|
676
841
|
}
|
|
842
|
+
function normalizeSkillScriptPath(value, memberName) {
|
|
843
|
+
if (isAbsolute(value)) {
|
|
844
|
+
throw new Error(`Skill member ${memberName} script path must be relative: ${value}`);
|
|
845
|
+
}
|
|
846
|
+
const normalized = value.replace(/^\.?\//, "").replace(/\\/g, "/");
|
|
847
|
+
if (!normalized || normalized.startsWith("../") || normalized.includes("/../")) {
|
|
848
|
+
throw new Error(`Skill member ${memberName} script path cannot escape scripts/: ${value}`);
|
|
849
|
+
}
|
|
850
|
+
return normalized;
|
|
851
|
+
}
|
|
677
852
|
async function assertPathExists(rootDir, relativePath) {
|
|
678
853
|
await access(join(rootDir, relativePath), constants.F_OK);
|
|
679
854
|
}
|
|
855
|
+
async function pathExists(rootDir, relativePath) {
|
|
856
|
+
try {
|
|
857
|
+
await assertPathExists(rootDir, relativePath);
|
|
858
|
+
return true;
|
|
859
|
+
} catch {
|
|
860
|
+
return false;
|
|
861
|
+
}
|
|
862
|
+
}
|
|
863
|
+
async function collectRelativeFiles(rootDir, relativeDir) {
|
|
864
|
+
const entries = await readdir(join(rootDir, relativeDir), { withFileTypes: true });
|
|
865
|
+
const files = [];
|
|
866
|
+
for (const entry of entries) {
|
|
867
|
+
if (entry.name.startsWith(".")) {
|
|
868
|
+
throw new Error(`Skill resources cannot contain hidden files or directories: ${join(relativeDir, entry.name)}`);
|
|
869
|
+
}
|
|
870
|
+
const relativePath = join(relativeDir, entry.name).replace(/\\/g, "/");
|
|
871
|
+
if (entry.isDirectory()) {
|
|
872
|
+
files.push(...await collectRelativeFiles(rootDir, relativePath));
|
|
873
|
+
continue;
|
|
874
|
+
}
|
|
875
|
+
files.push(relativePath);
|
|
876
|
+
}
|
|
877
|
+
return files.sort();
|
|
878
|
+
}
|
|
879
|
+
async function assertSkillResourceFiles(rootDir, member, relativeDir, label, allowedExtensions) {
|
|
880
|
+
for (const file of await collectRelativeFiles(rootDir, relativeDir)) {
|
|
881
|
+
if (!allowedExtensions.has(extname(file).toLowerCase())) {
|
|
882
|
+
throw new Error(`Skill member ${member.name} has unsupported ${label} file type: ${file}`);
|
|
883
|
+
}
|
|
884
|
+
const fileStat = await stat(join(rootDir, file));
|
|
885
|
+
if (fileStat.size > SKILL_RESOURCE_MAX_FILE_SIZE_BYTES) {
|
|
886
|
+
throw new Error(`Skill member ${member.name} ${label} file is too large: ${file}`);
|
|
887
|
+
}
|
|
888
|
+
}
|
|
889
|
+
}
|
|
680
890
|
function resolveNearestPackageRoot(startDir = process.cwd()) {
|
|
681
891
|
let current = resolve(startDir);
|
|
682
892
|
const root = parse(current).root;
|
|
@@ -2409,8 +2619,8 @@ async function runAstCheck(options) {
|
|
|
2409
2619
|
}
|
|
2410
2620
|
const full = join(dir, entry);
|
|
2411
2621
|
try {
|
|
2412
|
-
const
|
|
2413
|
-
if (
|
|
2622
|
+
const stat4 = statSync(full);
|
|
2623
|
+
if (stat4.isDirectory()) {
|
|
2414
2624
|
files2.push(...findFiles(full, extensions));
|
|
2415
2625
|
} else if (extensions.includes(extname(full))) {
|
|
2416
2626
|
files2.push(full);
|
|
@@ -3356,6 +3566,22 @@ function renderOutput(data, options = {}) {
|
|
|
3356
3566
|
}
|
|
3357
3567
|
console.dir(data, { depth: null, colors: true });
|
|
3358
3568
|
}
|
|
3569
|
+
function formatAddonPublishResult(result, organizationCode) {
|
|
3570
|
+
const lines = [
|
|
3571
|
+
`Addon published: ${result.addon.name}@${result.version.version}`,
|
|
3572
|
+
`Scope: ${result.addon.scope}`,
|
|
3573
|
+
`Status: ${result.addon.status}`
|
|
3574
|
+
];
|
|
3575
|
+
if (result.addon.scope === "organization") {
|
|
3576
|
+
lines.push(`Organization: ${organizationCode || result.addon.ownerOrganization?.code || "-"}`);
|
|
3577
|
+
if (result.addon.status !== "active") {
|
|
3578
|
+
lines.push("");
|
|
3579
|
+
lines.push("Next step:");
|
|
3580
|
+
lines.push(` amaster addon activate ${result.addon.name} --organization-code ${organizationCode || "<code>"}`);
|
|
3581
|
+
}
|
|
3582
|
+
}
|
|
3583
|
+
return lines.join("\n");
|
|
3584
|
+
}
|
|
3359
3585
|
function shouldRenderJsonError(argv) {
|
|
3360
3586
|
return argv.includes("--json");
|
|
3361
3587
|
}
|
|
@@ -3610,7 +3836,7 @@ addJsonOption(addOrganizationOption(addRegistryOption(addon.command("publish [so
|
|
|
3610
3836
|
scope: options.scope,
|
|
3611
3837
|
organizationCode: options.organizationCode
|
|
3612
3838
|
});
|
|
3613
|
-
renderOutput(result, options);
|
|
3839
|
+
renderOutput(options.json ? result : formatAddonPublishResult(result, options.organizationCode), options);
|
|
3614
3840
|
});
|
|
3615
3841
|
addJsonOption(addOrganizationOption(addRegistryOption(addon.command("activate <name>").description("Activate an addon")))).action(async (name, options) => {
|
|
3616
3842
|
const registry = resolveRegistryFromOptions(options);
|