hafez 1.2.0 → 1.4.0

package/dist/cli/commands.d.ts

@@ -1,16 +1,37 @@
-import { z } from 'zod';
+import { type FlagSpec } from './args.js';
 import type { Hafez, BatchOperation } from '../types.js';
 export interface CommandOpts {
     json?: boolean;
+    /** Resolved vault path — for handlers that read the vault directly
+     * (export) rather than through the Hafez instance. */
+    vaultPath?: string;
 }
 export declare function cmdRead(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
+/** Every flag the query parser accepts, for the branch-support matrix. */
+export declare const QUERY_FLAG_NAMES: string[];
+export type QueryBranch = 'entity' | 'knowledge' | 'all' | 'related-to';
+/** Which flags each kind branch actually applies. A branch that cannot honour
+ * a flag rejects it (below) instead of dropping it: `--kind knowledge --filter
+ * stale` used to return every knowledge note with exit 0, and `--confidence`
+ * never reached an entity query at all. */
+export declare const QUERY_FLAG_SUPPORT: Record<QueryBranch, readonly string[]>;
 export declare function cmdQuery(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
 export declare function cmdSearch(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
+/** Exported so tests can assert the flag × kind matrix is exhaustive. */
+export declare const CREATE_FLAGS: FlagSpec;
 export declare function cmdCreate(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
+/** Exported so tests can assert the table covers the update schema. */
+export declare const UPDATE_FLAGS: FlagSpec;
+/** Flags the generic loop skips because they are not a field of the update
+ * shape — each is hand-handled in cmdUpdate. */
+export declare const UPDATE_SPECIAL_FLAGS: Set<string>;
+/** Update-shape fields with no flag of their own, and why. The exhaustiveness
+ * test consults this, so a gap here is a stated decision rather than the
+ * silent hole `add_actions` was. */
+export declare const UPDATE_FIELDS_WITHOUT_FLAGS: Record<string, string>;
 export declare function cmdUpdate(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
 export declare function cmdLink(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
 export declare function cmdUnlink(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
-/** Top-level capture command — aligns the CLI verb with the batch op name. */
 export declare function cmdCapture(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
 export declare function cmdPromote(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
 export declare function cmdValidate(os: Hafez, _args: string[], opts?: CommandOpts): Promise<string>;
@@ -18,112 +39,7 @@ export declare function cmdIndexRebuild(os: Hafez): Promise<string>;
 export declare function cmdSync(os: Hafez, _args: string[]): Promise<string>;
 export declare function cmdStats(os: Hafez, _args: string[], opts?: CommandOpts): Promise<string>;
 export declare function cmdChangelog(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
-export declare const SessionLogSchema: z.ZodObject<{
-    type: z.ZodEnum<{
-        [x: string]: string;
-    }>;
-    summary: z.ZodString;
-    body: z.ZodOptional<z.ZodString>;
-    agent: z.ZodString;
-}, z.core.$strict>;
-export declare const UpdateFieldsSchema: z.ZodObject<{
-    status: z.ZodOptional<z.ZodEnum<{
-        [x: string]: string;
-    }>>;
-    current_state: z.ZodOptional<z.ZodString>;
-    session_log: z.ZodOptional<z.ZodObject<{
-        type: z.ZodEnum<{
-            [x: string]: string;
-        }>;
-        summary: z.ZodString;
-        body: z.ZodOptional<z.ZodString>;
-        agent: z.ZodString;
-    }, z.core.$strict>>;
-    brief: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    add_action: z.ZodOptional<z.ZodString>;
-    add_actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    complete_action: z.ZodOptional<z.ZodString>;
-    remove_action: z.ZodOptional<z.ZodString>;
-    clear_actions: z.ZodOptional<z.ZodBoolean>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    resource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    domain: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    confidence: z.ZodOptional<z.ZodEnum<{
-        [x: string]: string;
-    }>>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    related: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    synthesis: z.ZodOptional<z.ZodString>;
-    insight: z.ZodOptional<z.ZodString>;
-    add_evidence: z.ZodOptional<z.ZodString>;
-    add_source: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const BatchOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    op: z.ZodLiteral<"update">;
-    slug: z.ZodString;
-    fields: z.ZodObject<{
-        status: z.ZodOptional<z.ZodEnum<{
-            [x: string]: string;
-        }>>;
-        current_state: z.ZodOptional<z.ZodString>;
-        session_log: z.ZodOptional<z.ZodObject<{
-            type: z.ZodEnum<{
-                [x: string]: string;
-            }>;
-            summary: z.ZodString;
-            body: z.ZodOptional<z.ZodString>;
-            agent: z.ZodString;
-        }, z.core.$strict>>;
-        brief: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        add_action: z.ZodOptional<z.ZodString>;
-        add_actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        complete_action: z.ZodOptional<z.ZodString>;
-        remove_action: z.ZodOptional<z.ZodString>;
-        clear_actions: z.ZodOptional<z.ZodBoolean>;
-        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        resource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        domain: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        confidence: z.ZodOptional<z.ZodEnum<{
-            [x: string]: string;
-        }>>;
-        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        related: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        synthesis: z.ZodOptional<z.ZodString>;
-        insight: z.ZodOptional<z.ZodString>;
-        add_evidence: z.ZodOptional<z.ZodString>;
-        add_source: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-}, z.core.$strict>, z.ZodObject<{
-    op: z.ZodLiteral<"create">;
-}, z.core.$strip>, z.ZodObject<{
-    op: z.ZodLiteral<"capture">;
-    name: z.ZodString;
-    notes: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>, z.ZodObject<{
-    op: z.ZodLiteral<"link">;
-    slug: z.ZodString;
-    target: z.ZodString;
-    relation: z.ZodEnum<{
-        parent: "parent";
-        related: "related";
-    }>;
-}, z.core.$strict>, z.ZodObject<{
-    op: z.ZodLiteral<"unlink">;
-    slug: z.ZodString;
-    target: z.ZodString;
-    relation: z.ZodEnum<{
-        parent: "parent";
-        related: "related";
-    }>;
-}, z.core.$strict>, z.ZodObject<{
-    op: z.ZodLiteral<"promote">;
-    slug: z.ZodString;
-    target: z.ZodEnum<{
-        entity: "entity";
-        project: "project";
-        knowledge: "knowledge";
-    }>;
-}, z.core.$strict>], "op">;
 export declare function parseBatchInput(json: string): BatchOperation[];
 export declare function cmdBatch(os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;
 export declare function cmdDigest(os: Hafez, args: string[], _opts?: CommandOpts): Promise<string>;
+export declare function cmdExport(_os: Hafez, args: string[], opts?: CommandOpts): Promise<string>;