@vibe-agent-toolkit/cli 0.2.0-rc.11 → 0.2.0-rc.12

package/dist/commands/skills/package-schema.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The document `vat skills package` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes).
+ *
+ * `examined` is the one skill the run was pointed at. Every finding the
+ * validation gate produced is on the envelope, located as the validator
+ * located it; a claude.ai ZIP over its 8 MB ceiling adds
+ * `SKILL_PACKAGE_TOO_LARGE`, located at the skill's `SKILL.md`.
+ */
+import { z } from 'zod';
+import type { ExaminedDeclaration } from '../../utils/run-integrity.js';
+/** What `examined` counts for `vat skills package`, and the remedy when it is zero. */
+export declare const SKILLS_PACKAGE_EXAMINED: ExaminedDeclaration;
+declare const SkillsPackageDataSchema: z.ZodObject<{
+    /** The skill's name: its frontmatter `name`, else its H1, else its directory. */
+    skill: z.ZodString;
+    /** The frontmatter `version`, or `null` when the skill declares none or packaging never read it. */
+    version: z.ZodNullable<z.ZodString>;
+    /** The packaged skill directory, or `null` when the validation gate stopped the run before packaging. */
+    outputPath: z.ZodNullable<z.ZodString>;
+    /** `true` for `--dry-run`: `outputPath` is where the package WOULD go, and nothing was written. */
+    dryRun: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    skill: string;
+    version: string | null;
+    outputPath: string | null;
+    dryRun: boolean;
+}, {
+    skill: string;
+    version: string | null;
+    outputPath: string | null;
+    dryRun: boolean;
+}>;
+export type SkillsPackageData = z.infer<typeof SkillsPackageDataSchema>;
+/** The document this command publishes. */
+export declare const SKILLS_PACKAGE_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    /** The skill's name: its frontmatter `name`, else its H1, else its directory. */
+    skill: z.ZodString;
+    /** The frontmatter `version`, or `null` when the skill declares none or packaging never read it. */
+    version: z.ZodNullable<z.ZodString>;
+    /** The packaged skill directory, or `null` when the validation gate stopped the run before packaging. */
+    outputPath: z.ZodNullable<z.ZodString>;
+    /** `true` for `--dry-run`: `outputPath` is where the package WOULD go, and nothing was written. */
+    dryRun: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    skill: string;
+    version: string | null;
+    outputPath: string | null;
+    dryRun: boolean;
+}, {
+    skill: string;
+    version: string | null;
+    outputPath: string | null;
+    dryRun: boolean;
+}>, z.ZodObject<Omit<{
+    code: z.ZodString;
+    severity: z.ZodEnum<["error", "warning", "info", "ignore"]>;
+    message: z.ZodString;
+    location: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    line: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    fix: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodString>;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, "severity"> & {
+    severity: z.ZodEnum<["error", "warning", "info"]>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}>>;
+export {};
+//# sourceMappingURL=package-schema.d.ts.map

package/dist/commands/skills/package-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-schema.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/package-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,uFAAuF;AACvF,eAAO,MAAM,uBAAuB,EAAE,mBAGrC,CAAC;AAEF,QAAA,MAAM,uBAAuB;IAC3B,iFAAiF;;IAEjF,oGAAoG;;IAEpG,yGAAyG;;IAEzG,mGAAmG;;;;;;;;;;;;EAE1F,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,2CAA2C;AAC3C,eAAO,MAAM,4BAA4B;IAbvC,iFAAiF;;IAEjF,oGAAoG;;IAEpG,yGAAyG;;IAEzG,mGAAmG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOL,CAAC"}

package/dist/commands/skills/package-schema.js

@@ -0,0 +1,32 @@
+/**
+ * The document `vat skills package` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes).
+ *
+ * `examined` is the one skill the run was pointed at. Every finding the
+ * validation gate produced is on the envelope, located as the validator
+ * located it; a claude.ai ZIP over its 8 MB ceiling adds
+ * `SKILL_PACKAGE_TOO_LARGE`, located at the skill's `SKILL.md`.
+ */
+import { FindingSchema, reportSchema } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+/** What `examined` counts for `vat skills package`, and the remedy when it is zero. */
+export const SKILLS_PACKAGE_EXAMINED = {
+    unit: 'skills',
+    whenZero: 'Point the command at the SKILL.md file of the skill to package.',
+};
+const SkillsPackageDataSchema = z.object({
+    /** The skill's name: its frontmatter `name`, else its H1, else its directory. */
+    skill: z.string(),
+    /** The frontmatter `version`, or `null` when the skill declares none or packaging never read it. */
+    version: z.string().nullable(),
+    /** The packaged skill directory, or `null` when the validation gate stopped the run before packaging. */
+    outputPath: z.string().nullable(),
+    /** `true` for `--dry-run`: `outputPath` is where the package WOULD go, and nothing was written. */
+    dryRun: z.boolean(),
+}).strict();
+/** The document this command publishes. */
+export const SKILLS_PACKAGE_REPORT_SCHEMA = reportSchema(SkillsPackageDataSchema, FindingSchema);
+//# sourceMappingURL=package-schema.js.map

package/dist/commands/skills/package-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-schema.js","sourceRoot":"","sources":["../../../src/commands/skills/package-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,uFAAuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAwB;IAC1D,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,iEAAiE;CAC5E,CAAC;AAEF,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,iFAAiF;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,oGAAoG;IACpG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,yGAAyG;IACzG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,mGAAmG;IACnG,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,4BAA4B,GAAG,YAAY,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC"}

package/dist/commands/skills/package.d.ts

@@ -3,9 +3,14 @@
  *
  * Creates distributable artifacts (directory, ZIP, npm) from a SKILL.md file
  */
-import { type ValidationResult } from '@vibe-agent-toolkit/agent-skills';
-import { type SeverityCounts } from '@vibe-agent-toolkit/schema';
+import { type PackageSkillOptions, type PackagingTarget, type SkillPackageChecksFailedError, type ValidationResult } from '@vibe-agent-toolkit/agent-skills';
+import { type ParseResult } from '@vibe-agent-toolkit/resources';
+import { type Report, type ValidationIssue } from '@vibe-agent-toolkit/schema';
 import { Command } from 'commander';
+import { createLogger } from '../../utils/logger.js';
+import type { SkillsPackageData } from './package-schema.js';
+/** One format `packageSkill` can produce. */
+type PackageFormat = NonNullable<PackageSkillOptions['formats']>[number];
 export interface SkillsPackageCommandOptions {
     output: string;
     formats?: string;
@@ -14,6 +19,7 @@ export interface SkillsPackageCommandOptions {
     dryRun?: boolean;
     debug?: boolean;
     target?: string;
+    force?: boolean;
 }
 /**
  * Whether packaging should rewrite relative links in copied files.
@@ -37,19 +43,84 @@ export declare function resolveRewriteLinks(options: Pick<SkillsPackageCommandOp
  */
 export declare function resolveBasePath(options: Pick<SkillsPackageCommandOptions, 'basePath'>, skillPath: string): string;
 export declare function createPackageCommand(): Command;
+/** What one `skills package` run produced, for {@link buildSkillsPackageReport}. */
+interface SkillsPackageReportInput {
+    /** The validation the gate ran — its findings are the report's. */
+    validation: ValidationResult;
+    data: SkillsPackageData;
+    /**
+     * The packager refused the skill: a claude-web ZIP over 8 MB
+     * (`SKILL_PACKAGE_TOO_LARGE`) or the skill's own content
+     * (`SKILL_PACKAGING_FAILED`) — its message, and the skill's `SKILL.md` location.
+     */
+    refused?: {
+        code: 'SKILL_PACKAGE_TOO_LARGE' | 'SKILL_PACKAGING_FAILED';
+        message: string;
+        location: string;
+        thrown: unknown;
+    } | undefined;
+    /**
+     * What the package run itself found: the post-build checks a package failed (it then did not
+     * land), and what its plan made and could not remove — a previous package parked by the swap,
+     * a staged tree a refused run discarded — each the warning naming it. Required: a lane that
+     * forgot them would publish a clean report over a failure or a leftover.
+     */
+    runFindings: readonly ValidationIssue[];
+}
+/**
+ * THE document of one run. `examined` is the one skill; every validation
+ * finding is published whatever its severity, so the status is the literal
+ * `ok`/`findings` and the exit code derives from the counts — warnings never
+ * block (no `--strict`), an error does.
+ */
+export declare function buildSkillsPackageReport(input: SkillsPackageReportInput): Report<SkillsPackageData>;
 /**
- * The header a `skills package` run publishes: the verdict of the validation it
- * actually ran, with that validation's distribution beside it.
+ * Render the validation report: a headline that names what was found, then every
+ * issue labelled with its own severity.
  *
- * `status` used to be the literal `success`, printed next to counts drawn from
- * the very validation whose verdict it contradicted — so a skill `vat skills
- * build` reports as `warning` was reported here as `success`. Two lanes, one
- * skill, two answers. The counts alone did not close it: a consumer reading
- * `status` (the field the docs tell them to read) never saw the disagreement.
- */
-export declare function buildPackageHeader(validation: ValidationResult): {
-    status: 'success' | 'warning' | 'error';
-    issueCounts: SeverityCounts;
-};
+ * Two silent drops used to live here. The renderer filtered to `error` and
+ * `warning` only, so every `info` finding vanished; and the caller only invoked
+ * it for an error result, so a warning-severity result printed a bare
+ * `✅ Validation passed` — exactly the case that got swallowed.
+ */
 export declare function formatSkillValidationLines(validationResult: ValidationResult): string[];
+/**
+ * Extract skill name from parse result
+ */
+declare function extractSkillName(parseResult: ParseResult): string;
+/** A path as the report publishes it: relative to the working directory, forward slashes. */
+declare function reportPath(path: string): string;
+/** The frontmatter `version` as the report publishes it: a string, or `null` when none is declared. */
+declare function frontmatterVersion(parseResult: ParseResult): string | null;
+/**
+ * The `--formats` value, or the invocation's mistake. An unknown name used to
+ * be dropped by the packager, so `--formats zpi` wrote only the directory and
+ * exited 0.
+ */
+declare function resolvePackageFormats(rawFormats: string | undefined): PackageFormat[];
+/** Test seam: the report's pure field derivations, and the `--formats` resolver. */
+export declare const __internal: {
+    extractSkillName: typeof extractSkillName;
+    failedChecksReport: typeof failedChecksReport;
+    frontmatterVersion: typeof frontmatterVersion;
+    reportPath: typeof reportPath;
+    resolvePackageFormats: typeof resolvePackageFormats;
+    resolveTarget: typeof resolveTarget;
+};
+/**
+ * Which finding a `packageSkill` throw is, or `undefined` for a defect. Only
+ * the packager's CODED refusals are findings about the skill — the claude.ai
+ * ZIP ceiling, and its refusal of the skill's own content; an uncoded throw is
+ * VAT's, and reaches the command's `INTERNAL_ERROR`.
+ */
+export declare function packagingRefusalCode(error: unknown): 'SKILL_PACKAGE_TOO_LARGE' | 'SKILL_PACKAGING_FAILED' | undefined;
+/** The `--target` value, or the invocation's mistake. */
+declare function resolveTarget(rawTarget: string): PackagingTarget;
+/**
+ * A package its own post-build checks failed: it did not land (the previous output is as it was),
+ * and this lane publishes the checks' own findings — exit 1, `outputPath: null` — with what the
+ * discard could not remove.
+ */
+declare function failedChecksReport(error: SkillPackageChecksFailedError, validation: ValidationResult, logger: ReturnType<typeof createLogger>): Report<SkillsPackageData>;
+export {};
 //# sourceMappingURL=package.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/package.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,2BAA2B,EAAE,cAAc,CAAC,GACzD,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,IAAI,CAAC,2BAA2B,EAAE,UAAU,CAAC,EACtD,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CA6D9C;AAkCD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,gBAAgB,GAAG;IAChE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,WAAW,EAAE,cAAc,CAAC;CAC7B,CAEA;AAmBD,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAiBvF"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/package.ts"],"names":[],"mappings":"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"}