cyber-agentkit 1.1.0 → 2.0.0

package/dist/commands.d.ts

@@ -1,56 +1,15 @@
-import { O as ReferenceWarning, a as ReferenceTrace, b as ReferencePlugin, u as ResolvedReference } from "./resolve-reference-D62VJZc0.js";
-import { cli } from "clibuilder";
-//#region src/references/reference.command.d.ts
-/** `show`'s entry for a name: its content alone when `found` with nothing else to say, else a record. */
-type ReferenceShowEntry = string | {
-  name: string;
-  status: ResolvedReference['status'];
-  content?: string;
-  /** Set when the answer is not Markdown. */
-  format?: string;
-  code?: string;
-  options?: string[];
-  metadata?: Record<string, unknown>;
-  warnings?: ReferenceWarning[];
-  trace?: ReferenceTrace;
-};
-type ReferenceListReport = {
-  /** A string when nothing matches, so a run states its zero explicitly. */
-  references: {
-    name: string;
-    description?: string;
-    format?: string;
-    status?: string;
-    options?: string[];
-  }[] | string;
-  /** Why some skills' defaults are not listed; left out when every detected harness's skill folders were read. */
-  defaults?: string;
-  layers?: {
-    name: string;
-    tier: string;
-    plugin?: string;
-    skill?: string;
-    path: string;
-    description?: string;
-    outcome: string;
-    selection?: boolean;
-    reachedBy?: string;
-  }[];
-  warnings?: ReferenceWarning[];
-};
-type ReferenceSearchReport = {
-  references: {
-    name: string;
-    description?: string;
-    match: string;
-    loadedBy?: string;
-    tier?: string;
-    plugin?: string;
-    skill?: string;
-  }[] | string;
-  /** Why some skills' defaults are not searched. */
-  defaults?: string;
+import { $ as AssetPlugin, E as ReferencePlugin, G as ReferenceWarning, W as ReferenceStatusCode, _ as ResolvedProjectSection, c as ReferenceTrace, p as ResolvedReference, t as ReferenceWhereFile } from "./reference-where-BsBpwLyg.js";
+import { cli, t } from "clibuilder";
+//#region src/assets/asset-resolve.command.d.ts
+type AssetResolveCommandOptions = {
+  /** The plugin running the command; see `AssetLayerOptions['plugin']`. */
+  plugin?: AssetPlugin | undefined;
 };
+//#endregion
+//#region src/assets/asset.command.d.ts
+export declare function createAssetCommand(options?: AssetResolveCommandOptions): cli.Command;
+//#endregion
+//#region src/references/reference-check.command.d.ts
 type ReferenceCheckReport = {
   failed?: {
     name: string;
@@ -59,6 +18,13 @@ type ReferenceCheckReport = {
       check: string;
       message: string;
     }[];
+    warnings?: ReferenceWarning[];
+  }[];
+  /** The entries that pass with a warning, which never fails a check. */
+  warned?: {
+    name: string;
+    loadedBy?: string;
+    warnings: ReferenceWarning[];
   }[];
   passed: number;
   references?: {
@@ -71,8 +37,76 @@ type ReferenceCheckReport = {
       message: string;
     }[];
     unsupported?: string[];
+    warnings?: ReferenceWarning[];
   }[];
 };
+//#endregion
+//#region src/references/reference-create.command.d.ts
+/** A write's report is informational (R38), except its `code` and `warnings`, which are contract (J25). */
+type ReferenceCreateReport = {
+  path: string;
+  /** A project section's folder, relative to the root. */
+  folder?: string;
+  hint: string;
+  content?: string;
+  hints?: string[];
+  warnings?: ReferenceWarning[];
+  trace?: ReferenceTrace;
+};
+//#endregion
+//#region src/references/reference-customize.command.d.ts
+/** `customize --base`: what the generator reads for the target (R84). */
+type ReferenceCustomizeBase = {
+  status: string;
+  stack?: string[];
+  /** The interface's stub when one is named, then the main document built for the target. */
+  content: string;
+  /** For a folder target: the project sections of the folders above it. */
+  projectSections?: Pick<ResolvedProjectSection, 'folder' | 'content'>[];
+};
+/** A write's report is informational (R38), except its `code` and `warnings`, which are contract (J25). */
+type ReferenceCustomizeReport = {
+  path: string;
+  /** A project section's folder, relative to the root. */
+  folder?: string;
+  /** A non-Markdown name's metadata file, which holds the record. */
+  metadataFile?: string;
+  /** `no-selection` when `--extends none` found none: a no-op, exit 0. */
+  code?: 'no-selection';
+  message?: string;
+  extends?: unknown[];
+  deleted?: boolean;
+  status?: string;
+  stack?: string[];
+  answer?: string;
+  hint?: string;
+  content?: string;
+  metadataContent?: string;
+  hints?: string[];
+  warnings?: ReferenceWarning[];
+  trace?: ReferenceTrace;
+};
+//#endregion
+//#region src/references/reference-delete.command.d.ts
+/** A write's report is informational (R38), except its `code`, which is contract (J25). */
+type ReferenceDeleteReport = {
+  path: string;
+  /** A project section's folder, relative to the root. */
+  folder?: string;
+  /** The metadata file that went with a non-Markdown file. */
+  metadataFile?: string;
+  /** `no-file` when there was no file to delete: a no-op, exit 0. */
+  code?: 'no-file';
+  message?: string;
+  dryRun?: boolean;
+  status: string;
+  stack?: string[];
+  answer: string;
+  selection?: string;
+  options?: string[];
+};
+//#endregion
+//#region src/references/reference-implementations.command.d.ts
 type ReferenceImplementationsReport = {
   implementations: {
     pin: string;
@@ -81,7 +115,7 @@ type ReferenceImplementationsReport = {
     name?: string;
     tier?: string;
     version?: number;
-  }[] | string;
+  }[];
   interface?: string;
   cardinality?: string;
   accept?: number[];
@@ -91,56 +125,97 @@ type ReferenceImplementationsReport = {
   }[];
   warnings?: ReferenceWarning[];
 };
-type ReferenceWhereOutput = {
-  name: string;
-  status: string;
-  places: {
-    scope: string;
+//#endregion
+//#region src/references/reference-list.command.d.ts
+type ReferenceListReport = {
+  references: {
+    name: string;
+    description?: string;
+    format?: string;
+    status?: string;
+    code?: ReferenceStatusCode;
+    options?: string[];
+  }[];
+  /** Why some skills' defaults are not listed; left out when every detected harness's skill folders were read. */
+  defaults?: string;
+  layers?: {
+    name: string;
+    tier: string;
+    plugin?: string;
+    skill?: string;
     path: string;
-    reaches: string;
-    status: string;
-    sections?: string[];
+    description?: string;
+    outcome: string;
+    kind?: string;
+    folder?: string;
+    reachedBy?: string;
   }[];
-  options?: string[];
-  layers?: ReferenceTrace['layers'];
   warnings?: ReferenceWarning[];
 };
-/** The fields of `create`, `select`, and `delete` are not a contract yet (spec Q4). */
-type ReferenceCreateReport = {
-  path: string;
-  hint: string;
+//#endregion
+//#region src/references/reference-load.command.d.ts
+/** `load`'s entry for a name: its content alone when `found` with nothing else to say, else a record. */
+type ReferenceLoadEntry = string | {
+  name: string;
+  status: ResolvedReference['status'];
   content?: string;
-  hints?: string[];
+  /** What each folder below the root adds after the main document, in path order. */
+  projectSections?: {
+    folder: string;
+    plugin?: string;
+    content: string;
+  }[];
+  /** Set when the answer is not Markdown. */
+  format?: string;
+  code?: ReferenceStatusCode;
+  options?: string[];
+  metadata?: Record<string, unknown>;
+  warnings?: ReferenceWarning[];
   trace?: ReferenceTrace;
 };
-type ReferenceSelectReport = {
-  path: string;
-  extends?: string[];
-  deleted?: boolean;
-  status: string;
-  stack?: string[];
-  answer: string;
+//#endregion
+//#region src/references/reference-search.command.d.ts
+type ReferenceSearchReport = {
+  references: {
+    name: string;
+    description?: string;
+    match: string;
+    folder?: string;
+    loadedBy?: string;
+    tier?: string;
+    plugin?: string;
+    skill?: string;
+  }[];
+  /** Why some skills' defaults are not searched. */
+  defaults?: string;
 };
-type ReferenceDeleteReport = {
-  path: string;
-  dryRun?: boolean;
+//#endregion
+//#region src/references/reference-where.command.d.ts
+type ReferenceWhereOutput = {
+  name: string;
   status: string;
-  stack?: string[];
-  answer: string;
-  selection?: string;
+  files: ReferenceWhereFile[];
+  headings?: string[];
+  used?: string[];
   options?: string[];
+  /** Informational: the plugins and default the stack uses are read-only (UC2.6). */
+  hint?: string;
+  layers?: ReferenceTrace['layers'];
+  warnings?: ReferenceWarning[];
 };
+//#endregion
+//#region src/references/reference.command.d.ts
 type ReferenceCommandOptions = {
   /** The plugin running the command; see `ReferenceLayerOptions['plugin']`. */
   plugin?: ReferencePlugin | undefined;
 };
 type ReferenceCommands = {
-  show: cli.Command;
+  load: cli.Command;
   list: cli.Command;
   search: cli.Command;
   where: cli.Command;
   create: cli.Command;
-  select: cli.Command;
+  customize: cli.Command;
   delete: cli.Command;
   check: cli.Command;
   implementations: cli.Command;
@@ -149,7 +224,4 @@ type ReferenceCommands = {
 export declare function createReferenceCommands({ plugin }?: ReferenceCommandOptions): ReferenceCommands;
 export declare function createReferenceCommand(options?: ReferenceCommandOptions): cli.Command;
 //#endregion
-//#region src/assets/asset.command.d.ts
-export declare function createAssetCommand(options?: ReferenceCommandOptions): cli.Command;
-//#endregion
-export type { ReferenceCheckReport, ReferenceCommandOptions, ReferenceCommands, ReferenceCreateReport, ReferenceDeleteReport, ReferenceImplementationsReport, ReferenceListReport, ReferenceSearchReport, ReferenceSelectReport, ReferenceShowEntry, ReferenceWhereOutput };
+export type { ReferenceCheckReport, ReferenceCommandOptions, ReferenceCommands, ReferenceCreateReport, ReferenceCustomizeBase, ReferenceCustomizeReport, ReferenceDeleteReport, ReferenceImplementationsReport, ReferenceListReport, ReferenceLoadEntry, ReferenceSearchReport, ReferenceWhereOutput };