@adhd/backlog 1.0.1 → 1.0.3

package/cli-input-envelope.d.ts

@@ -0,0 +1,40 @@
+import { ComposedSchemas, Operation } from '@adhd/apigen-core-client';
+
+/** The top-level keys whose presence marks the MCP envelope shape. */
+export declare const ENVELOPE_WRAPPER_KEYS: readonly ["input", "data"];
+/** A detected MCP-envelope-shaped `--input`, with everything the message needs. */
+export interface ICliInputEnvelopeViolation {
+    /** The envelope keys found at the top level of the parsed `--input` value. */
+    wrapperKeys: string[];
+    /**
+     * The exact command a consumer should type, as the CLI's own help renders it
+     * (`project(op).cli.path.join(' ')`, e.g. `backlog get`).
+     */
+    commandLabel: string;
+    /**
+     * A minimal, schema-derived JSON example of the verb's BARE params, already
+     * JSON-encoded (`'{"uid":"<string>"}'`). `undefined` only when the verb's
+     * composed schema could not be found (e.g. a synthetic mount command).
+     */
+    exampleJson: string | undefined;
+}
+/**
+ * Detects an `--input` value that carries the MCP envelope shape. `argv` is
+ * the FULL, namespace-prefixed argv (what `prefixCommand` produces) so command
+ * matching lines up with the operation paths.
+ *
+ * Returns `undefined` — i.e. no interception — for: a missing `--input`, a
+ * non-object value, an unparseable value, a `--help` invocation, an
+ * unrecognized command, and a bare object that merely happens to declare a
+ * `data`/`input` field the verb's schema actually owns (the check consults the
+ * verb's own properties, so a legitimate field of that name is never
+ * misflagged).
+ */
+export declare function detectCliInputEnvelopeViolation(argv: readonly string[], operations: readonly Operation[], schemas: ComposedSchemas): ICliInputEnvelopeViolation | undefined;
+/**
+ * Renders the actionable rejection: names the bare-params contract, shows a
+ * concrete correct invocation for the invoked verb, and identifies the
+ * envelope as the MCP calling convention. Deliberately a single sentence-run
+ * with NO raw AJV output — the guidance must not be buried under a union dump.
+ */
+export declare function renderCliInputEnvelopeMessage(violation: ICliInputEnvelopeViolation): string;

package/index.d.ts

@@ -16,3 +16,7 @@ export type { BacklogConfig, BuildBacklogEnvOptions } from './env.js';
 export { openGraphBacklogStore, closeGraphBacklogStore, } from './store/graph-backlog-store.js';
 export type { GraphBacklogStore } from './store/graph-backlog-store.js';
 export { readBacklogVersionInfo } from './version-info.js';
+export { RESERVED_TERMINAL_STATUS_NAMES, catalogNameFold, planTerminalBackfill, applyTerminalBackfill, reverseTerminalBackfill, } from './write/catalog-repair.js';
+export type { ITerminalBackfillPlan, ITerminalBackfillJournal, } from './write/catalog-repair.js';
+export { planCaseFragmentMerge, applyCaseFragmentMerge, reverseCaseFragmentMerge, } from './write/catalog-merge.js';
+export type { IMergePlan, IMergeJournal, IMergeJournalEntry, } from './write/catalog-merge.js';