@skillcdn/console 0.4.1 → 0.4.3

package/dist/cli/help.js

@@ -1,4 +1,4 @@
-import { DEFAULT_PAGE_LIMIT, MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_CATEGORIES, MAX_CATEGORY_KEY_LENGTH, MAX_CATEGORY_NAME_LENGTH, MAX_COMMENTS_PER_TASK, MAX_DECISIONS_PER_PROJECT, MAX_DOCUMENT_LENGTH, MAX_DOCUMENT_PATH_LENGTH, MAX_DOCUMENTS_PER_PROJECT, MAX_FILE_BYTES, MAX_FILES_PER_COMMENT, MAX_FILES_PER_DOCUMENT, MAX_GOALS_PER_PROJECT, MAX_LINK_LABEL_LENGTH, MAX_NOTE_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_PROJECT_DESCRIPTION_LENGTH, MAX_PROJECT_ICON_BYTES, MAX_PROJECT_KEY_LENGTH, MAX_PROJECT_NAME_LENGTH, MAX_PROJECT_SYMBOL_LENGTH, MAX_PROJECTS_PER_WORKSPACE, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_RULES_LENGTH, MAX_RUNS_PER_TASK, MAX_SEARCH_LENGTH, MAX_SUMMARY_LENGTH, MAX_TASKS_PER_PROJECT, MAX_TITLE_LENGTH, MAX_VERSIONS_PER_DOCUMENT, MAX_WORKERS, MIN_OPTIONS, } from "../limits.js";
+import { DEFAULT_PAGE_LIMIT, MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_CATEGORIES, MAX_CATEGORY_KEY_LENGTH, MAX_CATEGORY_NAME_LENGTH, MAX_COMMENTS_PER_TASK, MAX_DECISIONS_PER_PROJECT, MAX_DOCUMENT_LENGTH, MAX_DOCUMENT_PATH_LENGTH, MAX_DOCUMENTS_PER_PROJECT, MAX_FILE_BYTES, MAX_FILES_PER_COMMENT, MAX_FILES_PER_DECISION, MAX_FILES_PER_DOCUMENT, MAX_GOALS_PER_PROJECT, MAX_LINK_LABEL_LENGTH, MAX_NOTE_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_PROJECT_DESCRIPTION_LENGTH, MAX_PROJECT_ICON_BYTES, MAX_PROJECT_KEY_LENGTH, MAX_PROJECT_NAME_LENGTH, MAX_PROJECT_SYMBOL_LENGTH, MAX_PROJECTS_PER_WORKSPACE, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_RULES_LENGTH, MAX_RUNS_PER_TASK, MAX_SEARCH_LENGTH, MAX_SUMMARY_LENGTH, MAX_TASKS_PER_PROJECT, MAX_TITLE_LENGTH, MAX_VERSIONS_PER_DOCUMENT, MAX_WORKERS, MIN_OPTIONS, } from "../limits.js";
 import { COLOR_NAMES } from "../vocabulary.js";
 /** The refusals any command may meet, said once in the overview. */
 const COMMON_REFUSALS = [
@@ -245,7 +245,7 @@ export const COMMAND_HELP = {
     rules: {
         usage: "rules  |  rules write --body <markdown>|--file <path>|-|none [--workspace] [--base <version>]",
         synopsis: "What this organization and this project ask of agents; rules write writes them, for an owner or an administrator.",
-        about: "What this organization asks of agents (ADR-0023): the workspace's rules, the console's own until an administrator writes the organization's, and this project's own when it has them. rules write writes this project's rules, for an owner, or with --workspace the workspace's, for an administrator; none puts the written rules away, so that the console's own hold again, or the project adds none. Without a project named, rules shows the workspace's alone.",
+        about: "What this organization asks of agents (ADR-0023): the workspace's rules, the console's own until an administrator writes the organization's, and this project's own when it has them. rules write writes this project's rules, for an owner, or with --workspace the workspace's, for an administrator; none puts the written rules away, so that the console's own hold again, or the project adds none. Without a project named, rules shows the workspace's alone. After the rules, a section Plugins names the plugins bound to the project that you hold a role in, or at the workspace every plugin you may use, a line each with the sentence its manifest gives agents and where to start: console plugin <key>.",
         limits: [
             `body: Markdown, up to ${MAX_RULES_LENGTH} characters; the console's own rules, written as they are, write nothing`,
         ],
@@ -254,10 +254,39 @@ export const COMMAND_HELP = {
             "document.conflict: the rules have moved on since --base; read them again",
         ],
     },
+    plugins: {
+        usage: "plugins",
+        synopsis: "The plugins of this console you may use: key, name, version, state, your roles.",
+        about: "The plugins of this console (docs/specs/plugins.md), one a line: the enabled ones a member may use, every one with its state for an administrator; the key, the name, the version, the state, the roles you hold in it. A plugin is worked through console plugin <key>, and the rules of a board name the plugins to use there under Plugins, a sentence each. Needs no project.",
+    },
+    plugin: {
+        usage: "plugin <key>  |  plugin <key> help [<command>]  |  plugin <key> <command> [<args>] [--<name> <value>]... [--file <path> | -] [--run <id>]  |  plugin <key> records <collection> [<id>] [--where <field>=<value>]... [--search <words>] [--project <key>] [--order <field>[:desc]] [--limit <n>] [--after <cursor>] [--archived] [--versions]  |  plugin <key> skills [<folder>|<file>] [--search <words> [--limit <n>] [--cursor <cursor>]]  |  plugin <key> skill <path>  |  plugin <key> skill --file <path> [--offset <n>] [--limit <n>]  |  plugin <key> enable --consent <capability>,... [--board new|<key>] [--projects all|<key>,...] [--set <key>=<value>]...  |  plugin <key> disable  |  plugin <key> settings [--set <key>=<value>]...  |  plugin <key> secret <name> [--remove]  |  plugin <key> grant <role> --person <login>|--project <key>|--everyone  |  plugin <key> revoke <grant id>",
+        overview: "plugin <key> [help [<command>] | <command> [<args>] | records <collection> | skills | skill <path> | enable | disable | settings | secret | grant | revoke]",
+        synopsis: "One plugin: what it is for and its commands; a command run as you; its records, its skills; its settings, for an administrator.",
+        about: "One plugin of this console, by its key. Alone: what it is, the sentence for agents, its state, the roles you hold in it, its board project, then one line per command and query you may run, with its usage, where its skills are, and its settings. help [<command>]: one command or query in full, as console help prints one: its arguments, their types and bounds, and the refusals; every argument is given by its place when positional, else as --<name> <value> or --<name>=<value>; a boolean as --<name> alone; a list as the flag given again, or with commas between; a day as YYYY-MM-DD; a person by login, or me; a project by key; a file by --file <path>, or - for standard input, which the command uploads first, with the plugin's files capability. <command> [<args>]: runs the command or the query as the person whose token you hold; the console parses the words against the definition and refuses the first that does not fit; prints what the command says, or a query's answer as JSON, a file a query answers saved under its name; --json prints the whole answer. A command that raised a decision prints its id and exits with 3: console decision <id> --wait 100 waits for the answer. The event the command leaves names your open run in the plugin's board project, --run <id> saying which when several are open; an argument marked secret is hidden in it. records <collection>: the records you may read, one a line, newest first; --where <field>=<value>, given again for several, narrows by a field the collection indexes (id, owner and project always; a number, true, false and null are read as such); --search <words> by words; --project <key> to those linked to a project; --order <field>, with :desc for the newest first; a page of --limit with --after <cursor> as the last page printed; --archived the ones put away; <id> reads one record whole, --versions its versions. skills and skill: the plugin's own skills, a pack read from its package, exactly as console skills and console skill read a project's pack. enable, disable, settings, secret, grant and revoke are an administrator's. enable prints what each capability the plugin asks opens and what a malicious plugin would reach through it, and refuses unless --consent names every capability again; --board new makes the board project the manifest proposes, --board <key> chooses one, left out where the plugin needs none; --projects all, or the keys of the projects the plugin is on; --set a setting's value, which settings changes afterwards too, an empty value clearing one, a number or true and false read as such. secret <name> reads the value from standard input, seals it and shows it never; --remove takes it away. grant gives a role to a person by login, to the members of a project by key, or to everyone, and revoke takes a grant back by its id, which console plugin <key> lists to an administrator.",
+        limits: [
+            "a command line: up to 200 words of up to 50,000 characters each; one file, up to the file bound (console help hand-in), with the plugin's files capability",
+            "records: a page of up to 200; where: a field the collection indexes",
+            "enable: consent names every capability the manifest asks; settings and secrets as the manifest bounds them",
+        ],
+        refusals: [
+            "plugin.not_found: no plugin has that key, or you may not know of it; or the plugin has no such command or query",
+            "plugin.disabled: the plugin is installed and not enabled",
+            "plugin.unavailable: the plugin failed to load, its host is away, or this deployment lacks what it needs",
+            "plugin.forbidden: the command, the record or the file needs a role you do not hold in the plugin, or the plugin lacks the capability",
+            "plugin.invalid_args: a word does not fit the definition; the message names the first at fault",
+            "plugin.timeout: the plugin's code ran past its time",
+            "plugin.too_many: a quota of the plugin is reached",
+            "plugin.needs_consent, plugin.requires, plugin.required_by: enabling without consent to every capability; a plugin this one requires is not enabled or not in range; another enabled plugin requires this one",
+            "plugin.failed: the plugin's code failed; the console's log says what it said, the answer does not",
+            "plugin.<key>.<code>: the plugin's own refusal, in its own words",
+            "auth.forbidden: enable, disable, settings, secret, grant and revoke are an administrator's",
+        ],
+    },
     take: {
         usage: "take <number|id> [--agent <name>]",
         synopsis: "Takes a task: a run begins, and the task is in progress and the person's.",
-        about: "Takes a task: a run begins, and the task is in progress and the person's; the run's id and the task's id are printed on a line of their own, then the task, then the rules of the board. A run still open on the task is taken over, since the board cannot know whether its agent still runs: it ends as abandoned, the feed says who took over, and that agent is refused on its next command; console task <number> shows the runs on a task, with when each was last heard from, before it is taken. --agent is what people see at work; left out, it is what the person called the token.",
+        about: "Takes a task: a run begins, and the task is in progress and the person's; the run's id and the task's id are printed on a line of their own, then the task, then the rules of the board, with a section Plugins after them where plugins are bound to the project: a line per plugin you may use there, which console plugin <key> then says how to use. A run still open on the task is taken over, since the board cannot know whether its agent still runs: it ends as abandoned, the feed says who took over, and that agent is refused on its next command; console task <number> shows the runs on a task, with when each was last heard from, before it is taken. --agent is what people see at work; left out, it is what the person called the token.",
         limits: [
             `agent: one line, up to ${MAX_AGENT_LENGTH} characters`,
             `at most ${MAX_RUNS_PER_TASK} runs on one task`,
@@ -298,14 +327,16 @@ export const COMMAND_HELP = {
         ],
     },
     ask: {
-        usage: 'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--to <login|me>] [--wait <seconds>] [--run <id>]',
-        overview: 'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--to <login|me>] [--wait <seconds>]',
+        usage: 'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--attach <path>]... [--to <login|me>] [--wait <seconds>] [--run <id>]',
+        overview: 'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--attach <path>]... [--to <login|me>] [--wait <seconds>]',
         synopsis: "Raises a decision a person must make, with options, and waits a while for the answer.",
-        about: `Raises a decision a person must make: the question, the options to choose from, and what they need to know. It is for the person you work for unless --to names another of the project, who then finds it among their decisions (ADR-0042); anyone of the project may still answer. The run waits for the answer. The command waits 60 seconds for it unless --wait says otherwise, and exits with 3 if it is still to come: keep waiting with \`console decision <id> --wait 100\`, within what your shell gives one command. The decision's id is printed as soon as it is raised. The person chooses one of the options, or answers in their own words: the answer then names one more option, their words, marked own; act on it as given. ${ON_THE_RUN}`,
+        about: `Raises a decision a person must make: the question, the options to choose from, and what they need to know. --attach puts a file on the decision, in the one request: a picture of what is to be chosen between, a screenshot of what was made; a picture the body names as ![words](its name) is shown there, the rest after the body, and the person reads each back with \`console file <id>\` (ADR-0055). It is for the person you work for unless --to names another of the project, who then finds it among their decisions (ADR-0042); anyone of the project may still answer. The run waits for the answer. The command waits 60 seconds for it unless --wait says otherwise, and exits with 3 if it is still to come: keep waiting with \`console decision <id> --wait 100\`, within what your shell gives one command. The decision's id is printed as soon as it is raised. The person chooses one of the options, or answers in their own words: the answer then names one more option, their words, marked own; act on it as given. ${ON_THE_RUN}`,
         limits: [
             `question: one line, up to ${MAX_QUESTION_LENGTH} characters`,
             `options: ${MIN_OPTIONS} to ${MAX_OPTIONS}, each one line up to ${MAX_OPTION_LABEL_LENGTH} characters`,
             `body: ${MARKDOWN}`,
+            `attach: a file: up to ${MAX_FILE_BYTES} bytes, not empty; called by its name, without the path; a picture is placed in the body as ![words](its name)`,
+            `at most ${MAX_FILES_PER_DECISION} files on one decision, together up to ${MAX_FILE_BYTES} bytes`,
             "to: a login of the project, or me",
             `at most ${MAX_DECISIONS_PER_PROJECT} decisions in one project`,
         ],
@@ -314,6 +345,8 @@ export const COMMAND_HELP = {
             "decision.invalid_run: the run is not yours, or is over",
             "decision.invalid_decider: the person named may not work in the project",
             "decision.too_many: the project holds as many decisions as one may",
+            "decision.too_many_files: more files than one decision carries",
+            "request.too_large: a file, or the files together, over the bound",
         ],
     },
     answer: {
@@ -397,7 +430,7 @@ export const COMMAND_HELP = {
     file: {
         usage: "file <id> [--out <path>]",
         synopsis: "Reads a file of the project to this machine, by its id.",
-        about: "Reads a file of the project from the console and writes it on this machine: one a run handed in, one put in a comment, or one attached to a page, by the id the task, the run or the page shows. Written under its own name in the working directory, at --out <path>, or into --out <directory>. Then look at it with your own tools.",
+        about: "Reads a file of the project from the console and writes it on this machine: one a run handed in, one put in a comment or on a decision, or one attached to a page, by the id the task, the run, the decision or the page shows. Written under its own name in the working directory, at --out <path>, or into --out <directory>. Then look at it with your own tools.",
         refusals: ["file.not_found: no file of this project has that id"],
     },
     docs: {
@@ -528,6 +561,10 @@ const SECTIONS = [
             "rules",
         ],
     },
+    {
+        title: "The plugins of this console, if it has any: a feature added to the board, worked through one command",
+        commands: ["plugins", "plugin"],
+    },
     {
         title: "Working",
         commands: [

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,8BAA8B,EAC9B,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,EACzB,WAAW,EACX,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAyB/C,oEAAoE;AACpE,MAAM,eAAe,GAAG;IACtB,gHAAgH;IAChH,mLAAmL;IACnL,0FAA0F;IAC1F,0DAA0D;CAC3D,CAAC;AAEF,yGAAyG;AACzG,MAAM,UAAU,GAAG;IACjB,oGAAoG;IACpG,yFAAyF;CAC1F,CAAC;AAEF,MAAM,YAAY,GAAG;IACnB,GAAG,UAAU;IACb,4CAA4C;IAC5C,qCAAqC;CACtC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,UAAU,GAAG,mEAAmE,CAAC;AAEvF,MAAM,QAAQ,GAAG,mBAAmB,eAAe,aAAa,CAAC;AAEjE,MAAM,aAAa,GAAG,gHAAgH,wBAAwB,8CAA8C,CAAC;AAC7M,MAAM,iBAAiB,GAAG,CAAC,2DAA2D,CAAC,CAAC;AAExF,MAAM,GAAG,GAAG,uEAAuE,CAAC;AACpF,MAAM,MAAM,GAAG,UAAU,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAClD,MAAM,GAAG,GAAG,uCAAuC,CAAC;AACpD,MAAM,gBAAgB,GACpB,gKAAgK,CAAC;AACnK,MAAM,iBAAiB,GAAG;IACxB,gBAAgB,GAAG,uCAAuC;IAC1D,yIAAyI;IACzI,oGAAoG,WAAW,4KAA4K;CAC5R,CAAC;AACF,MAAM,mBAAmB,GAAG;IAC1B,iDAAiD;IACjD,wDAAwD;IACxD,qDAAqD;IACrD,6EAA6E;IAC7E,oFAAoF;CACrF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAA0C;IACjE,KAAK,EAAE;QACL,KAAK,EAAE,mEAAmE;QAC1E,QAAQ,EACN,oGAAoG;QACtG,KAAK,EACH,u+BAAu+B;QACz+B,QAAQ,EAAE;YACR,6GAA6G;YAC7G,sFAAsF;SACvF;KACF;IACD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE,sEAAsE;QAChF,KAAK,EACH,wJAAwJ;KAC3J;IACD,MAAM,EAAE;QACN,KAAK,EAAE,6CAA6C;QACpD,QAAQ,EAAE,iEAAiE;QAC3E,KAAK,EACH,6WAA6W;KAChX;IACD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE,qFAAqF;QAC/F,KAAK,EACH,sIAAsI;KACzI;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,0DAA0D;QACpE,KAAK,EACH,uJAAuJ;KAC1J;IACD,GAAG,EAAE;QACH,KAAK,EAAE,gDAAgD;QACvD,QAAQ,EACN,8HAA8H;QAChI,KAAK,EACH,ouBAAouB;QACtuB,QAAQ,EAAE,CAAC,sEAAsE,CAAC;KACnF;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,yBAAyB;QAChC,QAAQ,EACN,iGAAiG;QACnG,KAAK,EACH,2YAA2Y;KAC9Y;IACD,KAAK,EAAE;QACL,KAAK,EACH,yLAAyL;QAC3L,QAAQ,EACN,iHAAiH;QACnH,KAAK,EAAE,syBAAsyB,kBAAkB,oJAAoJ;QACn9B,MAAM,EAAE,CAAC,gBAAgB,iBAAiB,aAAa,CAAC;KACzD;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,2EAA2E,gBAAgB,kFAAkF,gBAAgB,yFAAyF;QAC7R,QAAQ,EACN,uJAAuJ;QACzJ,QAAQ,EAAE,yEAAyE;QACnF,KAAK,EACH,upBAAupB;QACzpB,MAAM,EAAE;YACN,0BAA0B,gBAAgB,uFAAuF;YACjI,SAAS,QAAQ,EAAE;YACnB,GAAG,iBAAiB;YACpB,WAAW,qBAAqB,+CAA+C;SAChF;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,GAAG,mBAAmB;YACtB,gGAAgG;SACjG;KACF;IACD,KAAK,EAAE;QACL,KAAK,EACH,4FAA4F;QAC9F,QAAQ,EAAE,qFAAqF;QAC/F,KAAK,EAAE,ybAAyb,kBAAkB,wFAAwF;QAC1iB,MAAM,EAAE,CAAC,gBAAgB,iBAAiB,aAAa,CAAC;KACzD;IACD,IAAI,EAAE;QACJ,KAAK,EACH,kSAAkS;QACpS,QAAQ,EAAE,mEAAmE;QAC7E,QAAQ,EACN,uFAAuF;QACzF,KAAK,EACH,sXAAsX;QACxX,MAAM,EAAE;YACN,0BAA0B,gBAAgB,aAAa;YACvD,SAAS,QAAQ,EAAE;YACnB,gBAAgB,GAAG,EAAE;YACrB,WAAW,qBAAqB,uBAAuB;SACxD;QACD,QAAQ,EAAE;YACR,qDAAqD;YACrD,kEAAkE;YAClE,wDAAwD;YACxD,2DAA2D;YAC3D,+DAA+D;SAChE;KACF;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE,+CAA+C;QACzD,KAAK,EACH,6MAA6M;KAChN;IACD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE,mEAAmE;QAC7E,KAAK,EACH,knBAAknB;KACrnB;IACD,SAAS,EAAE;QACT,KAAK,EACH,mPAAmP;QACrP,QAAQ,EACN,0FAA0F;QAC5F,QAAQ,EACN,6FAA6F;QAC/F,KAAK,EACH,0yCAA0yC;QAC5yC,QAAQ,EAAE;YACR,qFAAqF;YACrF,gEAAgE;YAChE,2JAA2J;YAC3J,gKAAgK;YAChK,gKAAgK;SACjK;KACF;IACD,MAAM,EAAE;QACN,KAAK,EACH,oKAAoK;QACtK,QAAQ,EACN,iGAAiG;QACnG,KAAK,EACH,orBAAorB;QACtrB,QAAQ,EAAE;YACR,wEAAwE;YACxE,0FAA0F;YAC1F,yEAAyE;YACzE,yEAAyE;YACzE,kEAAkE;SACnE;KACF;IACD,OAAO,EAAE;QACP,KAAK,EACH,4aAA4a;QAC9a,QAAQ,EACN,kLAAkL;QACpL,QAAQ,EACN,wFAAwF;QAC1F,KAAK,EACH,o8BAAo8B;QACt8B,MAAM,EAAE;YACN,QAAQ,GAAG,WAAW,sBAAsB,2CAA2C;YACvF,yBAAyB,uBAAuB,mCAAmC,8BAA8B,EAAE;YACnH,UAAU,MAAM,mBAAmB,yBAAyB,4GAA4G;YACxK,oDAAoD,sBAAsB,QAAQ;YAClF,WAAW,0BAA0B,4BAA4B;SAClE;QACD,QAAQ,EAAE;YACR,uEAAuE;YACvE,qFAAqF;YACrF,mDAAmD;YACnD,mEAAmE;YACnE,8EAA8E;YAC9E,6EAA6E;YAC7E,gDAAgD;YAChD,8GAA8G;YAC9G,6HAA6H;YAC7H,oEAAoE;SACrE;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,sDAAsD;QAChE,KAAK,EACH,gUAAgU;KACnU;IACD,MAAM,EAAE;QACN,KAAK,EACH,wIAAwI;QAC1I,QAAQ,EACN,8FAA8F;QAChG,KAAK,EACH,4iBAA4iB;QAC9iB,QAAQ,EAAE;YACR,gEAAgE;YAChE,2DAA2D;YAC3D,gFAAgF;YAChF,6HAA6H;YAC7H,2DAA2D;SAC5D;KACF;IACD,QAAQ,EAAE;QACR,KAAK,EACH,mIAAmI;QACrI,QAAQ,EAAE,6DAA6D;QACvE,KAAK,EACH,iKAAiK;QACnK,MAAM,EAAE;YACN,QAAQ,GAAG,WAAW,uBAAuB,2CAA2C;YACxF,yBAAyB,wBAAwB,uBAAuB,MAAM,sBAAsB;YACpG,WAAW,cAAc,8BAA8B;SACxD;QACD,QAAQ,EAAE;YACR,4DAA4D;YAC5D,qDAAqD;YACrD,8CAA8C;YAC9C,qHAAqH;YACrH,sEAAsE;SACvE;KACF;IACD,MAAM,EAAE;QACN,KAAK,EACH,0GAA0G;QAC5G,QAAQ,EACN,+GAA+G;QACjH,KAAK,EACH,qlDAAqlD;QACvlD,MAAM,EAAE,CAAC,6CAA6C,CAAC;QACvD,QAAQ,EAAE;YACR,qGAAqG;YACrG,iGAAiG;SAClG;KACF;IACD,KAAK,EAAE;QACL,KAAK,EAAE,mEAAmE;QAC1E,QAAQ,EACN,6HAA6H;QAC/H,KAAK,EACH,ioCAAioC;QACnoC,MAAM,EAAE,CAAC,oEAAoE,CAAC;QAC9E,QAAQ,EAAE;YACR,qGAAqG;YACrG,iGAAiG;YACjG,8EAA8E;SAC/E;KACF;IACD,KAAK,EAAE;QACL,KAAK,EACH,+FAA+F;QACjG,QAAQ,EACN,mHAAmH;QACrH,KAAK,EACH,ucAAuc;QACzc,MAAM,EAAE;YACN,yBAAyB,gBAAgB,0EAA0E;SACpH;QACD,QAAQ,EAAE;YACR,qFAAqF;YACrF,0EAA0E;SAC3E;KACF;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,mCAAmC;QAC1C,QAAQ,EAAE,2EAA2E;QACrF,KAAK,EACH,gkBAAgkB;QAClkB,MAAM,EAAE;YACN,0BAA0B,gBAAgB,aAAa;YACvD,WAAW,iBAAiB,mBAAmB;SAChD;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,8CAA8C;YAC9C,mGAAmG;SACpG;KACF;IACD,MAAM,EAAE;QACN,KAAK,EACH,gGAAgG;QAClG,QAAQ,EAAE,yDAAyD;QACnE,QAAQ,EAAE,uDAAuD;QACjE,KAAK,EAAE,oIAAoI,UAAU,EAAE;QACvJ,MAAM,EAAE;YACN,eAAe,QAAQ,aAAa;YACpC,WAAW,mBAAmB,qBAAqB;SACpD;QACD,QAAQ,EAAE,CAAC,GAAG,YAAY,EAAE,0DAA0D,CAAC;KACxF;IACD,SAAS,EAAE;QACT,KAAK,EAAE,gEAAgE;QACvE,QAAQ,EAAE,mDAAmD;QAC7D,QAAQ,EAAE,qEAAqE;QAC/E,KAAK,EAAE,uRAAuR,UAAU,EAAE;QAC1S,MAAM,EAAE;YACN,oBAAoB;YACpB,iBAAiB,cAAc,+DAA+D;YAC9F,0BAA0B,qBAAqB,aAAa;YAC5D,WAAW,qBAAqB,6BAA6B;SAC9D;QACD,QAAQ,EAAE;YACR,GAAG,YAAY;YACf,4DAA4D;YAC5D,+CAA+C;YAC/C,wHAAwH;SACzH;KACF;IACD,GAAG,EAAE;QACH,KAAK,EACH,kJAAkJ;QACpJ,QAAQ,EACN,qIAAqI;QACvI,QAAQ,EACN,uFAAuF;QACzF,KAAK,EAAE,ktBAAktB,UAAU,EAAE;QACruB,MAAM,EAAE;YACN,6BAA6B,mBAAmB,aAAa;YAC7D,YAAY,WAAW,OAAO,WAAW,yBAAyB,uBAAuB,aAAa;YACtG,SAAS,QAAQ,EAAE;YACnB,mCAAmC;YACnC,WAAW,yBAAyB,2BAA2B;SAChE;QACD,QAAQ,EAAE;YACR,GAAG,UAAU;YACb,wDAAwD;YACxD,wEAAwE;YACxE,mEAAmE;SACpE;KACF;IACD,MAAM,EAAE;QACN,KAAK,EAAE,6EAA6E;QACpF,QAAQ,EAAE,oFAAoF;QAC9F,KAAK,EACH,qiBAAqiB;QACviB,MAAM,EAAE;YACN,wBAAwB,uBAAuB,aAAa;YAC5D,yBAAyB,eAAe,aAAa;SACtD;QACD,QAAQ,EAAE;YACR,6CAA6C;YAC7C,uDAAuD;YACvD,kEAAkE;SACnE;KACF;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,uFAAuF;QAC9F,QAAQ,EACN,8FAA8F;QAChG,KAAK,EACH,mUAAmU;QACrU,MAAM,EAAE,CAAC,YAAY,QAAQ,EAAE,CAAC;QAChC,QAAQ,EAAE,CAAC,6CAA6C,CAAC;KAC1D;IACD,SAAS,EAAE;QACT,KAAK,EAAE,mEAAmE;QAC1E,QAAQ,EAAE,iFAAiF;QAC3F,KAAK,EAAE,iUAAiU,kBAAkB,mDAAmD;KAC9Y;IACD,MAAM,EAAE;QACN,KAAK,EAAE,4DAA4D;QACnE,QAAQ,EAAE,+CAA+C;QACzD,QAAQ,EAAE,gEAAgE;QAC1E,KAAK,EAAE,6MAA6M,UAAU,EAAE;QAChO,MAAM,EAAE,CAAC,YAAY,mBAAmB,kBAAkB,aAAa,EAAE,CAAC;QAC1E,QAAQ,EAAE,YAAY;KACvB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,0DAA0D;QACjE,QAAQ,EAAE,6CAA6C;QACvD,QAAQ,EAAE,2CAA2C;QACrD,KAAK,EAAE,qFAAqF,UAAU,EAAE;QACxG,MAAM,EAAE,CAAC,4BAA4B,kBAAkB,aAAa,CAAC;QACrE,QAAQ,EAAE,YAAY;KACvB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,6CAA6C;QACpD,QAAQ,EAAE,wCAAwC;QAClD,KAAK,EACH,+GAA+G;QACjH,MAAM,EAAE,CAAC,4BAA4B,kBAAkB,aAAa,CAAC;QACrE,QAAQ,EAAE,YAAY;KACvB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,0EAA0E;QACjF,QAAQ,EAAE,uEAAuE;QACjF,KAAK,EAAE,+JAA+J,kBAAkB,mDAAmD;KAC5O;IACD,GAAG,EAAE;QACH,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,gEAAgE;QAC1E,KAAK,EAAE,mFAAmF;QAC1F,QAAQ,EAAE,CAAC,mCAAmC,CAAC;KAChD;IACD,OAAO,EAAE;QACP,KAAK,EACH,uHAAuH;QACzH,QAAQ,EAAE,uEAAuE;QACjF,KAAK,EACH,4XAA4X;QAC9X,MAAM,EAAE;YACN,gBAAgB,QAAQ,wCAAwC;YAChE,iBAAiB,cAAc,gHAAgH;YAC/I,WAAW,qBAAqB,yCAAyC,cAAc,QAAQ;YAC/F,WAAW,qBAAqB,uBAAuB;SACxD;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,gEAAgE;YAChE,+DAA+D;YAC/D,0DAA0D;YAC1D,+HAA+H;SAChI;KACF;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,0BAA0B;QACjC,QAAQ,EAAE,yDAAyD;QACnE,KAAK,EACH,wUAAwU;QAC1U,QAAQ,EAAE,CAAC,qDAAqD,CAAC;KAClE;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,iDAAiD;QACxD,QAAQ,EAAE,0EAA0E;QACpF,KAAK,EACH,+MAA+M;KAClN;IACD,GAAG,EAAE;QACH,KAAK,EAAE,uCAAuC;QAC9C,QAAQ,EAAE,2CAA2C;QACrD,KAAK,EACH,8NAA8N;QAChO,QAAQ,EAAE,CAAC,GAAG,iBAAiB,EAAE,0DAA0D,CAAC;KAC7F;IACD,KAAK,EAAE;QACL,KAAK,EAAE,qFAAqF;QAC5F,QAAQ,EAAE,yEAAyE;QACnF,KAAK,EACH,scAAsc;QACxc,MAAM,EAAE;YACN,SAAS,aAAa,EAAE;YACxB,0BAA0B,gBAAgB,aAAa;YACvD,yBAAyB,mBAAmB,aAAa;YACzD,WAAW,yBAAyB,8BAA8B,yBAAyB,uBAAuB;SACnH;QACD,QAAQ,EAAE;YACR,4CAA4C;YAC5C,sEAAsE;YACtE,2DAA2D;YAC3D,4FAA4F;YAC5F,yFAAyF;SAC1F;KACF;IACD,MAAM,EAAE;QACN,KAAK,EAAE,wCAAwC;QAC/C,QAAQ,EAAE,8CAA8C;QACxD,KAAK,EACH,6JAA6J;QAC/J,MAAM,EAAE;YACN,iBAAiB,cAAc,+DAA+D;YAC9F,WAAW,sBAAsB,oBAAoB;SACtD;QACD,QAAQ,EAAE;YACR,GAAG,iBAAiB;YACpB,2DAA2D;YAC3D,oEAAoE;YACpE,+CAA+C;YAC/C,mIAAmI;SACpI;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE,gBAAgB;QACvB,QAAQ,EAAE,uCAAuC;QACjD,KAAK,EACH,qIAAqI;QACvI,QAAQ,EAAE,iBAAiB;KAC5B;IACD,OAAO,EAAE;QACP,KAAK,EAAE,gBAAgB;QACvB,QAAQ,EAAE,+BAA+B;QACzC,KAAK,EAAE,+BAA+B;QACtC,QAAQ,EAAE,iBAAiB;KAC5B;IACD,KAAK,EAAE;QACL,KAAK,EAAE,4BAA4B;QACnC,QAAQ,EACN,iHAAiH;QACnH,KAAK,EACH,mdAAmd;QACrd,QAAQ,EAAE,CAAC,yDAAyD,CAAC;KACtE;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,MAAM,IAAI,GACR,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;IAC/F,OAAO,GAAG,IAAI,oBAAoB,SAAS,UAAU,CAAC;AACxD,CAAC;AAED,wGAAwG;AACxG,MAAM,QAAQ,GAAG,CAAC,OAA2B,EAAE,SAA6B,EAAU,EAAE,CACtF,UAAU,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE;;;;wBAI9B,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,EAAE;;;;;CAKvH,CAAC;AAEF,MAAM,OAAO,GAAG;;;;;;;;;;;;EAYd,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;CAQ5D,CAAC;AAEF,MAAM,QAAQ,GAAgF;IAC5F;QACE,KAAK,EAAE,2DAA2D;QAClE,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;KACrE;IACD;QACE,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE;YACR,MAAM;YACN,OAAO;YACP,MAAM;YACN,OAAO;YACP,MAAM;YACN,YAAY;YACZ,WAAW;YACX,UAAU;YACV,MAAM;YACN,KAAK;YACL,QAAQ;YACR,OAAO;YACP,OAAO;SACR;KACF;IACD;QACE,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE;YACR,MAAM;YACN,QAAQ;YACR,SAAS;YACT,SAAS;YACT,MAAM;YACN,KAAK;YACL,QAAQ;YACR,QAAQ;YACR,MAAM;YACN,SAAS;SACV;KACF;IACD;QACE,KAAK,EAAE,qEAAqE;QAC5E,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;KACnE;IACD;QACE,KAAK,EACH,qHAAqH;QACvH,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC;KACxF;CACF,CAAC;AAEF,+GAA+G;AAC/G,MAAM,UAAU,KAAK,CAAC,OAAgB,EAAE,SAAkB;IACxD,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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"}

package/dist/cli/plugin-check.d.ts

@@ -0,0 +1,26 @@
+import type { ServerLoad } from "../plugin/load.js";
+export interface CheckReport {
+    readonly ok: boolean;
+    readonly errors: readonly string[];
+    readonly warnings: readonly string[];
+    /** One line about what was found, when the package read at all. */
+    readonly summary: string | null;
+}
+/** SPDX identifiers under which a plugin may ship into an image: permissive only. */
+export declare const PERMISSIVE_LICENSES: readonly string[];
+/** `(MIT OR Apache-2.0)` is fine when one side is; `MIT AND X` only when both are. */
+export declare function isPermissiveLicense(expression: string): boolean;
+/** True when npm's `files` list ships the path: named, under a named directory, or matched by a simple glob. */
+export declare function coveredByFiles(files: readonly string[], path: string): boolean;
+/** The classes a stylesheet styles, each once; comments and quoted strings are not read. */
+export declare function classesIn(css: string): string[];
+/** What a web bundle reaches for that a frame has no business with, or imports from elsewhere. */
+export declare function webBundleProblems(source: string): string[];
+/**
+ * The words of the manifest, as JSON, whose translation repeats the English words (`name.ko`,
+ * for one): what `init --languages` copies for the author to translate, and what was left.
+ */
+export declare function sameAsEnglish(value: unknown, at?: string): string[];
+/** Reads the plugin at `root` as a console would, and says what it would refuse. */
+export declare function checkPlugin(root: string, loadServer: (file: string) => Promise<ServerLoad>): Promise<CheckReport>;
+//# sourceMappingURL=plugin-check.d.ts.map

package/dist/cli/plugin-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-check.d.ts","sourceRoot":"","sources":["../../src/cli/plugin-check.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAUpD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAYhD,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAS/D;AAED,gHAAgH;AAChH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA0B9E;AAKD,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAS/C;AAMD,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAkB1D;AAgMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,SAAK,GAAG,MAAM,EAAE,CAe/D;AAED,oFAAoF;AACpF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,GAChD,OAAO,CAAC,WAAW,CAAC,CAgKtB"}

package/dist/cli/plugin-check.js

@@ -0,0 +1,396 @@
+// `console-plugin check` (docs/specs/plugins.md, "Authoring"): reads a plugin's package as the
+// console would and names everything a console, or a store, would refuse it for: the manifest,
+// the package's own manifest, the server module under the host's hardening and against the
+// manifest, the web bundle's self-containment and its classes, the skills, the migrations.
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, posix } from "node:path";
+import { descriptionProblems } from "../plugin/define.js";
+import { CURRENT_PLUGIN_API, PLUGIN_API_MAJORS, parsePluginManifest, } from "../plugin/manifest.js";
+import { forbiddenImportsIn, removedGlobalsIn } from "../plugin/sandbox.js";
+import { isLanguageMap } from "./plugin-init.js";
+/** SPDX identifiers under which a plugin may ship into an image: permissive only. */
+export const PERMISSIVE_LICENSES = [
+    "MIT",
+    "MIT-0",
+    "ISC",
+    "0BSD",
+    "BSD-2-Clause",
+    "BSD-3-Clause",
+    "Apache-2.0",
+    "BlueOak-1.0.0",
+    "CC0-1.0",
+    "Unlicense",
+    "Zlib",
+];
+/** `(MIT OR Apache-2.0)` is fine when one side is; `MIT AND X` only when both are. */
+export function isPermissiveLicense(expression) {
+    const trimmed = expression.trim().replace(/^\(|\)$/g, "");
+    if (/\bOR\b/i.test(trimmed)) {
+        return trimmed.split(/\s+OR\s+/i).some(isPermissiveLicense);
+    }
+    if (/\bAND\b/i.test(trimmed)) {
+        return trimmed.split(/\s+AND\s+/i).every(isPermissiveLicense);
+    }
+    return PERMISSIVE_LICENSES.includes(trimmed);
+}
+/** True when npm's `files` list ships the path: named, under a named directory, or matched by a simple glob. */
+export function coveredByFiles(files, path) {
+    const target = posix.normalize(path).replace(/^\.\//, "");
+    return files.some((entry) => {
+        const pattern = posix.normalize(entry).replace(/^\.\//, "").replace(/\/$/, "");
+        if (pattern.startsWith("!")) {
+            return false;
+        }
+        if (pattern === target || target.startsWith(`${pattern}/`)) {
+            return true;
+        }
+        if (!/[*?]/.test(pattern)) {
+            return false;
+        }
+        const regex = new RegExp(`^${pattern
+            .split("**")
+            .map((part) => part
+            .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+            .replace(/\*/g, "[^/]*")
+            .replace(/\?/g, "[^/]"))
+            .join(".*")}(?:/.*)?$`);
+        return regex.test(target);
+    });
+}
+/** A class selector: a dot not after a digit or another dot (0.5em is a number), then a name. */
+const CLASS_SELECTOR = /(?<![\d.])\.(-?[A-Za-z_][\w-]*)/g;
+/** The classes a stylesheet styles, each once; comments and quoted strings are not read. */
+export function classesIn(css) {
+    const withoutComments = css.replace(/\/\*[\s\S]*?\*\//g, "").replace(/"[^"]*"|'[^']*'/g, '""');
+    const found = new Set();
+    for (const match of withoutComments.matchAll(CLASS_SELECTOR)) {
+        if (match[1] !== undefined && !/^\d/.test(match[1])) {
+            found.add(match[1]);
+        }
+    }
+    return [...found];
+}
+const WEB_IMPORT = /(?:\bfrom\s*|\bimport\s*\(?\s*|\bexport\s+\*\s+from\s*)["'`]([^"'`]+)["'`]/g;
+const WEB_FORBIDDEN = /\b(fetch|XMLHttpRequest|WebSocket|EventSource|importScripts|sendBeacon)\s*\(|document\.cookie|\bnavigator\.serviceWorker\b/g;
+/** What a web bundle reaches for that a frame has no business with, or imports from elsewhere. */
+export function webBundleProblems(source) {
+    const problems = new Set();
+    for (const match of source.matchAll(WEB_IMPORT)) {
+        const specifier = match[1] ?? "";
+        if (!specifier.startsWith("./") &&
+            !specifier.startsWith("../") &&
+            !specifier.startsWith("data:")) {
+            problems.add(`imports ${specifier} from elsewhere: a bundle is self-contained`);
+        }
+    }
+    for (const match of source.matchAll(WEB_FORBIDDEN)) {
+        problems.add(`uses ${match[1] ?? match[0]}: a frame speaks to the console through the bridge alone`);
+    }
+    return [...problems];
+}
+async function exists(path) {
+    try {
+        const found = await stat(path);
+        return found.isDirectory() ? "directory" : "file";
+    }
+    catch {
+        return null;
+    }
+}
+async function readJson(path) {
+    let text;
+    try {
+        text = await readFile(path, "utf8");
+    }
+    catch {
+        return { problem: `${posix.basename(path)} is missing` };
+    }
+    try {
+        return { value: JSON.parse(text) };
+    }
+    catch (error) {
+        return {
+            problem: `${posix.basename(path)} is not JSON: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+function frontMatter(text) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/.exec(text);
+    if (match === null) {
+        return null;
+    }
+    const scalars = {};
+    for (const line of (match[1] ?? "").split(/\r?\n/)) {
+        const key = /^([a-z][a-zA-Z]*):(?: (.*))?$/.exec(line);
+        if (key?.[1] !== undefined && key[2] !== undefined) {
+            scalars[key[1]] = key[2].replace(/^"(.*)"$/, "$1");
+        }
+    }
+    return { scalars, body: match[2] ?? "" };
+}
+async function checkSkills(root, skillsDir, errors, warnings) {
+    const manifestPath = join(root, "SKILLCDN.md");
+    const manifestText = await readFile(manifestPath, "utf8").catch(() => null);
+    if (manifestText === null) {
+        errors.push("SKILLCDN.md is missing at the package root: a plugin with skills has their manifest there");
+    }
+    else {
+        const matter = frontMatter(manifestText);
+        if (matter === null || !matter.scalars.name || !matter.scalars.description) {
+            errors.push("SKILLCDN.md has no front-matter with name and description");
+        }
+    }
+    const dir = join(root, skillsDir);
+    if ((await exists(dir)) !== "directory") {
+        errors.push(`skills names ${skillsDir}, which is not a directory`);
+        return 0;
+    }
+    let count = 0;
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const file = posix.join(skillsDir, entry.name, "SKILL.md");
+        const text = await readFile(join(root, file), "utf8").catch(() => null);
+        if (text === null) {
+            errors.push(`${file} is missing: a skill directory holds a SKILL.md`);
+            continue;
+        }
+        count += 1;
+        const matter = frontMatter(text);
+        if (matter === null) {
+            errors.push(`${file} has no front-matter`);
+            continue;
+        }
+        if (matter.scalars.name !== entry.name) {
+            errors.push(`${file} is named ${matter.scalars.name ?? "(nothing)"}, not ${entry.name} as its directory is`);
+        }
+        const description = matter.scalars.description ?? "";
+        if (description.length === 0 || description.length > 1024) {
+            errors.push(`${file} has a description of ${description.length} characters; 1 to 1024 are allowed`);
+        }
+        if (!/^\s*# /.test(matter.body)) {
+            errors.push(`${file} does not start its body with a level-one heading`);
+        }
+        if (matter.scalars.license === undefined) {
+            warnings.push(`${file} names no license`);
+        }
+    }
+    if (count === 0) {
+        warnings.push(`${skillsDir} holds no skill`);
+    }
+    return count;
+}
+async function checkMigrations(root, migrationsDir, errors) {
+    const dir = join(root, migrationsDir);
+    if ((await exists(dir)) !== "directory") {
+        errors.push(`migrations names ${migrationsDir}, which is not a directory`);
+        return;
+    }
+    const names = (await readdir(dir)).filter((name) => name.endsWith(".sql")).sort();
+    if (names.length === 0) {
+        errors.push(`${migrationsDir} holds no .sql file`);
+    }
+    for (const name of names) {
+        if (!/^\d{4}-[a-z0-9-]+\.sql$/.test(name)) {
+            errors.push(`${migrationsDir}/${name} is not named NNNN-<words>.sql`);
+        }
+    }
+}
+async function checkWeb(root, manifest, webDir, errors, warnings) {
+    const dir = join(root, webDir);
+    if ((await exists(dir)) !== "directory") {
+        errors.push(`web names ${webDir}, which is not a directory: build the bundle first`);
+        return;
+    }
+    const script = await readFile(join(dir, "index.js"), "utf8").catch(() => null);
+    if (script === null) {
+        errors.push(`${webDir}/index.js is missing: the frame loads the bundle from there`);
+    }
+    else {
+        for (const problem of webBundleProblems(script)) {
+            errors.push(`${webDir}/index.js ${problem}`);
+        }
+    }
+    const css = await readFile(join(dir, "index.css"), "utf8").catch(() => null);
+    if (css !== null) {
+        if (/@import\s+(?:url\()?["']?(?:https?:)?\/\//.test(css) ||
+            /url\(\s*["']?(?:https?:)?\/\//.test(css)) {
+            errors.push(`${webDir}/index.css loads from elsewhere: a bundle is self-contained`);
+        }
+        const prefix = `pl-${manifest.key}-`;
+        const strangers = classesIn(css).filter((name) => !name.startsWith(prefix) && !name.startsWith("sc-"));
+        if (strangers.length > 0) {
+            warnings.push(`${webDir}/index.css styles ${strangers.slice(0, 5).join(", ")}${strangers.length > 5 ? ", ..." : ""}: a plugin's classes begin with ${prefix}`);
+        }
+    }
+}
+function describeCounts(manifest, description) {
+    const counts = [
+        `${manifest.pages.length} pages`,
+        `${manifest.widgets.length} widgets`,
+        `${manifest.settings.length} settings`,
+        `${Object.keys(manifest.roles).length} roles`,
+    ];
+    if (description !== null) {
+        counts.unshift(`${description.collections.length} collections`, `${Object.keys(description.commands).length} commands`, `${Object.keys(description.queries).length} queries`, `${Object.keys(description.endpoints).length} endpoints`, `${description.hooks.length} hooks`, `${Object.keys(description.jobs).length} jobs`);
+    }
+    return counts.join(", ");
+}
+/**
+ * The words of the manifest, as JSON, whose translation repeats the English words (`name.ko`,
+ * for one): what `init --languages` copies for the author to translate, and what was left.
+ */
+export function sameAsEnglish(value, at = "") {
+    if (Array.isArray(value)) {
+        return value.flatMap((item, index) => sameAsEnglish(item, `${at}[${index}]`));
+    }
+    if (typeof value !== "object" || value === null) {
+        return [];
+    }
+    if (isLanguageMap(value)) {
+        return Object.entries(value)
+            .filter(([language, words]) => language !== "en" && words === value.en)
+            .map(([language]) => `${at}.${language}`.replace(/^\./, ""));
+    }
+    return Object.entries(value).flatMap(([key, inner]) => sameAsEnglish(inner, at.length === 0 ? key : `${at}.${key}`));
+}
+/** Reads the plugin at `root` as a console would, and says what it would refuse. */
+export async function checkPlugin(root, loadServer) {
+    const errors = [];
+    const warnings = [];
+    if ((await exists(root)) !== "directory") {
+        return { ok: false, errors: [`${root} is not a directory`], warnings, summary: null };
+    }
+    const manifestRead = await readJson(join(root, "console-plugin.json"));
+    if ("problem" in manifestRead) {
+        return { ok: false, errors: [manifestRead.problem], warnings, summary: null };
+    }
+    const parsed = parsePluginManifest(manifestRead.value);
+    if (!parsed.ok) {
+        return {
+            ok: false,
+            errors: parsed.problems.map((problem) => `console-plugin.json: ${problem}`),
+            warnings,
+            summary: null,
+        };
+    }
+    const manifest = parsed.manifest;
+    if (!PLUGIN_API_MAJORS.includes(manifest.pluginApi)) {
+        errors.push(`console-plugin.json: pluginApi ${manifest.pluginApi} is not one this command knows (${PLUGIN_API_MAJORS.join(", ")}); write against ${CURRENT_PLUGIN_API}`);
+    }
+    for (const path of sameAsEnglish(manifestRead.value)) {
+        warnings.push(`console-plugin.json: ${path} is the same as en: translate it, or leave the language out`);
+    }
+    const packageRead = await readJson(join(root, "package.json"));
+    let version = "0.0.0";
+    if ("problem" in packageRead) {
+        errors.push(packageRead.problem);
+    }
+    else {
+        const pkg = (typeof packageRead.value === "object" && packageRead.value !== null ? packageRead.value : {});
+        if (typeof pkg.name !== "string" || pkg.name.length === 0) {
+            errors.push("package.json: name is missing");
+        }
+        if (typeof pkg.version !== "string" ||
+            !/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(pkg.version)) {
+            errors.push("package.json: version is not a semver version");
+        }
+        else {
+            version = pkg.version;
+        }
+        if (typeof pkg.license !== "string" || !isPermissiveLicense(pkg.license)) {
+            errors.push(`package.json: license ${typeof pkg.license === "string" ? pkg.license : "(none)"} is not a permissive license (${PERMISSIVE_LICENSES.join(", ")})`);
+        }
+        if (pkg.type !== "module") {
+            errors.push('package.json: type is not "module"; the server module is ESM');
+        }
+        const scripts = (typeof pkg.scripts === "object" && pkg.scripts !== null ? pkg.scripts : {});
+        for (const hook of ["preinstall", "install", "postinstall"]) {
+            if (hook in scripts) {
+                errors.push(`package.json: has a ${hook} script; a plugin is installed with no install scripts`);
+            }
+        }
+        if (Array.isArray(pkg.files)) {
+            const files = pkg.files.filter((entry) => typeof entry === "string");
+            const shipped = [
+                "console-plugin.json",
+                manifest.server,
+                ...(manifest.web === undefined ? [] : [manifest.web]),
+                ...(manifest.skills === undefined ? [] : [manifest.skills, "SKILLCDN.md"]),
+                ...(manifest.migrations === undefined ? [] : [manifest.migrations]),
+            ];
+            for (const path of shipped) {
+                if (!coveredByFiles(files, path)) {
+                    errors.push(`package.json: files leaves out ${path}, which the console reads`);
+                }
+            }
+        }
+        else {
+            warnings.push("package.json: has no files list; everything in the directory is published");
+        }
+        if (typeof pkg.private === "boolean" && pkg.private) {
+            warnings.push("package.json: is private; take that out to publish");
+        }
+    }
+    let description = null;
+    const serverPath = join(root, manifest.server);
+    if ((await exists(serverPath)) !== "file") {
+        errors.push(`server names ${manifest.server}, which is missing: build the server module first`);
+    }
+    else {
+        const source = await readFile(serverPath, "utf8");
+        for (const specifier of forbiddenImportsIn(source)) {
+            errors.push(`${manifest.server} imports ${specifier}, which the host refuses`);
+        }
+        for (const name of removedGlobalsIn(source)) {
+            errors.push(`${manifest.server} calls ${name}, which the host removes; the console is reached through ctx`);
+        }
+        const load = await loadServer(serverPath);
+        if (!load.ok) {
+            errors.push(`${manifest.server} does not load under the host's hardening: ${load.error}`);
+            for (const problem of load.problems) {
+                errors.push(`${manifest.server}: ${problem}`);
+            }
+        }
+        else {
+            description = load.description;
+            if (description.pluginApi !== manifest.pluginApi) {
+                errors.push(`${manifest.server} was built against plugin API ${description.pluginApi}; the manifest says ${manifest.pluginApi}`);
+            }
+            for (const problem of descriptionProblems(description, manifest)) {
+                errors.push(`${manifest.server}: ${problem}`);
+            }
+            if (manifest.capabilities.includes("endpoints") &&
+                Object.keys(description.endpoints).length === 0) {
+                warnings.push("console-plugin.json: asks the capability endpoints and the server module defines no endpoint");
+            }
+            if (manifest.capabilities.includes("jobs") && Object.keys(description.jobs).length === 0) {
+                warnings.push("console-plugin.json: asks the capability jobs and the server module defines no job");
+            }
+        }
+    }
+    if (manifest.web !== undefined) {
+        await checkWeb(root, manifest, manifest.web, errors, warnings);
+    }
+    let skills = 0;
+    if (manifest.skills !== undefined) {
+        skills = await checkSkills(root, manifest.skills, errors, warnings);
+    }
+    else {
+        warnings.push("console-plugin.json: names no skills; an agent learns the plugin from its command's help alone");
+    }
+    if (manifest.migrations !== undefined) {
+        await checkMigrations(root, manifest.migrations, errors);
+    }
+    else if (manifest.capabilities.includes("storage:sql")) {
+        warnings.push("console-plugin.json: asks storage:sql and names no migrations");
+    }
+    return {
+        ok: errors.length === 0,
+        errors,
+        warnings,
+        summary: `${manifest.key} ${version}: ${describeCounts(manifest, description)}, ${skills} skills`,
+    };
+}
+//# sourceMappingURL=plugin-check.js.map