perttool 0.1.0-alpha.2 → 0.2.0

package/dist/command/registry.d.ts

@@ -0,0 +1,84 @@
+export type CommandHandler = "agent-help" | "analyze" | "check" | "domain-help" | "format" | "import" | "mutation" | "next" | "project-show" | "advance" | "render";
+export type SharedOptionGroup = "diagnostics" | "guide" | "preview" | "result" | "write";
+export interface OperandDescriptor {
+    readonly name: string;
+    readonly valueType: string;
+    readonly required: boolean;
+    readonly position: number;
+}
+export interface OptionDescriptor {
+    readonly name: string;
+    readonly kind: "flag" | "value";
+    readonly valueType: string | null;
+    readonly required: boolean;
+    readonly repeatable: boolean;
+    readonly defaultValue: string | number | boolean | null;
+    readonly enumValues: readonly string[];
+    readonly conflicts: readonly string[];
+    readonly requires: readonly string[];
+    readonly sharedGroup: SharedOptionGroup | null;
+    readonly spelling: {
+        readonly cli: string;
+        readonly dsl: string | null;
+        readonly json: string;
+    };
+}
+export interface ExitStatusDescriptor {
+    readonly code: 0 | 1 | 2 | 3 | 4 | 5 | 70;
+    readonly meaning: string;
+}
+export interface CommandExample {
+    readonly id: string;
+    readonly invocation: string;
+    readonly summary: string;
+}
+export interface CommandOutputDescriptor {
+    readonly formats: readonly ["text", "json"];
+    readonly payload: "result" | "candidate-document" | "artifact";
+    readonly fileEffect: "none" | "optional-create" | "optional-write-or-create";
+}
+export interface ProjectedCommandDescriptor {
+    readonly contractVersion: 2 | 3;
+    readonly path: readonly [command: string] | readonly [resource: string, action: string];
+    readonly operation: string;
+    readonly summary: string;
+    readonly operands: readonly OperandDescriptor[];
+    readonly options: readonly OptionDescriptor[];
+    readonly input: "none" | "document" | "artifact";
+    readonly output: CommandOutputDescriptor;
+    readonly stdin: {
+        readonly document: boolean;
+        readonly artifact: boolean;
+        readonly request: boolean;
+        readonly mutuallyExclusive: boolean;
+    };
+    readonly effect: "read" | "preview" | "write-or-create";
+    readonly resultSchemas: readonly string[];
+    readonly exitStatuses: readonly ExitStatusDescriptor[];
+    readonly examples: readonly CommandExample[];
+}
+export interface CommandDescriptor extends ProjectedCommandDescriptor {
+    readonly contractVersion: 2;
+    readonly path: readonly [resource: string, action: string];
+    readonly handler: CommandHandler;
+    readonly textHelp: readonly string[];
+    readonly topLevelUsage: string | null;
+}
+export declare const COMMAND_REGISTRY: readonly CommandDescriptor[];
+export declare function getCommandDescriptor(resource: string, action: string): CommandDescriptor | null;
+export declare function getCommandDescriptorByOperation(operation: string): CommandDescriptor | null;
+export declare function renderCommandHelp(descriptor: CommandDescriptor): string;
+export declare function commandDescriptorToJson(descriptor: ProjectedCommandDescriptor): Readonly<Record<string, unknown>>;
+export declare function commandRegistryToJson(): readonly Readonly<Record<string, unknown>>[];
+export declare function renderTopLevelHelp(): string;
+export declare function commandOptionSets(descriptor: ProjectedCommandDescriptor): {
+    readonly values: ReadonlySet<string>;
+    readonly flags: ReadonlySet<string>;
+    readonly repeatable: ReadonlySet<string>;
+};
+export declare function getAgentHelpCommandHelp(): {
+    readonly operation: string;
+    readonly summary: string;
+    readonly syntax: readonly string[];
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/command/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/command/registry.ts"],"names":[],"mappings":"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"}