@murphai/murph 0.1.1

package/dist/commands/search.js

@@ -0,0 +1,295 @@
+import { Cli, z } from 'incur';
+import { emptyArgsSchema, withBaseOptions } from '@murphai/assistant-core/command-helpers';
+import { ALL_QUERY_ENTITY_FAMILIES, loadQueryRuntime, } from '@murphai/assistant-core/query-runtime';
+import { isoTimestampSchema, localDateSchema, pathSchema, slugSchema, } from '@murphai/assistant-core/vault-cli-contracts';
+import { VaultCliError } from '@murphai/assistant-core/vault-cli-errors';
+import { normalizeRepeatableEnumFlagOption, normalizeRepeatableFlagOption, } from '@murphai/assistant-core/option-utils';
+const recordTypeValues = ALL_QUERY_ENTITY_FAMILIES;
+const timelineEntryTypeValues = [
+    'assessment',
+    'history',
+    'journal',
+    'profile_snapshot',
+    'event',
+    'sample_summary',
+];
+const searchBackendValues = ['auto', 'scan', 'sqlite'];
+const searchHitSchema = z.object({
+    recordId: z.string().min(1),
+    aliasIds: z.array(z.string().min(1)),
+    recordType: z.enum(recordTypeValues),
+    kind: z.string().min(1).nullable(),
+    stream: z.string().min(1).nullable(),
+    title: z.string().min(1).nullable(),
+    occurredAt: z.string().min(1).nullable(),
+    date: localDateSchema.nullable(),
+    experimentSlug: z.string().min(1).nullable(),
+    tags: z.array(z.string().min(1)),
+    path: pathSchema,
+    snippet: z.string(),
+    score: z.number(),
+    matchedTerms: z.array(z.string().min(1)),
+    citation: z.object({
+        path: pathSchema,
+        recordId: z.string().min(1),
+        aliasIds: z.array(z.string().min(1)),
+    }),
+});
+const searchResultSchema = z.object({
+    vault: pathSchema,
+    query: z.string().min(1),
+    filters: z.object({
+        text: z.string().min(1),
+        backend: z.enum(searchBackendValues),
+        recordTypes: z.array(z.enum(recordTypeValues)),
+        kinds: z.array(z.string().min(1)),
+        streams: z.array(z.string().min(1)),
+        experiment: slugSchema.nullable(),
+        from: localDateSchema.nullable(),
+        to: localDateSchema.nullable(),
+        tags: z.array(z.string().min(1)),
+        limit: z.number().int().positive().max(200),
+    }),
+    total: z.number().int().nonnegative(),
+    hits: z.array(searchHitSchema),
+});
+const timelineEntrySchema = z.object({
+    id: z.string().min(1),
+    entryType: z.enum(timelineEntryTypeValues),
+    occurredAt: z.string().min(1),
+    date: localDateSchema,
+    title: z.string().min(1),
+    kind: z.string().min(1),
+    stream: z.string().min(1).nullable(),
+    experimentSlug: z.string().min(1).nullable(),
+    path: pathSchema.nullable(),
+    relatedIds: z.array(z.string().min(1)),
+    tags: z.array(z.string().min(1)),
+    data: z.record(z.string(), z.unknown()),
+});
+const timelineResultSchema = z.object({
+    vault: pathSchema,
+    filters: z.object({
+        from: localDateSchema.nullable(),
+        to: localDateSchema.nullable(),
+        experiment: slugSchema.nullable(),
+        kinds: z.array(z.string().min(1)),
+        streams: z.array(z.string().min(1)),
+        entryTypes: z.array(z.enum(timelineEntryTypeValues)),
+        limit: z.number().int().positive().max(500),
+    }),
+    items: z.array(timelineEntrySchema),
+});
+const searchIndexStatusSchema = z.object({
+    vault: pathSchema,
+    backend: z.literal('sqlite'),
+    dbPath: pathSchema,
+    exists: z.boolean(),
+    schemaVersion: z.string().min(1).nullable(),
+    indexedAt: isoTimestampSchema.nullable(),
+    documentCount: z.number().int().nonnegative(),
+});
+const searchIndexRebuildSchema = searchIndexStatusSchema.extend({
+    rebuilt: z.literal(true),
+});
+export function registerSearchCommands(cli, _services) {
+    const search = Cli.create('search', {
+        description: 'Search commands for the local read model and the optional SQLite lexical index.',
+    });
+    search.command('query', {
+        description: 'Search the local read model with lexical scoring and optional SQLite-backed candidate retrieval.',
+        args: emptyArgsSchema,
+        options: withBaseOptions({
+            text: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Search text to run across titles, notes, tags, ids, and record payloads.'),
+            backend: z
+                .enum(searchBackendValues)
+                .optional()
+                .describe('Retrieval backend. Defaults to `auto`, which prefers SQLite when an index exists and otherwise falls back to the scan backend.'),
+            recordType: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Optional record families. Repeat --record-type for multiple values: core, experiment, journal, event, sample, audit, assessment, profile_snapshot, current_profile, goal, condition, allergy, protocol, history, family, genetics.'),
+            kind: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Optional record kinds such as meal, note, document, or journal_day. Repeat --kind for multiple values.'),
+            stream: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Optional sample streams; setting this also opts sample rows into search. Repeat --stream for multiple values.'),
+            experiment: slugSchema
+                .optional()
+                .describe('Optional experiment slug filter.'),
+            from: localDateSchema
+                .optional()
+                .describe('Inclusive lower date bound.'),
+            to: localDateSchema
+                .optional()
+                .describe('Inclusive upper date bound.'),
+            tag: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Optional tags that matching records must contain. Repeat --tag for multiple values.'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(200)
+                .default(20)
+                .describe('Maximum number of hits to return.'),
+        }),
+        output: searchResultSchema,
+        async run({ options }) {
+            const query = await loadQueryRuntime();
+            const text = options.text?.trim();
+            if (!text) {
+                throw new VaultCliError('invalid_query', 'Search text is required for `search query`.');
+            }
+            const recordTypes = normalizeRepeatableEnumFlagOption(options.recordType, 'record-type', recordTypeValues) ?? [];
+            const kinds = normalizeRepeatableFlagOption(options.kind, 'kind') ?? [];
+            const streams = normalizeRepeatableFlagOption(options.stream, 'stream') ?? [];
+            const tags = normalizeRepeatableFlagOption(options.tag, 'tag') ?? [];
+            const backend = options.backend ?? 'auto';
+            const result = await query.searchVaultRuntime(options.vault, text, {
+                recordTypes: recordTypes.length > 0 ? recordTypes : undefined,
+                kinds: kinds.length > 0 ? kinds : undefined,
+                streams: streams.length > 0 ? streams : undefined,
+                experimentSlug: options.experiment,
+                from: options.from,
+                to: options.to,
+                tags: tags.length > 0 ? tags : undefined,
+                limit: options.limit,
+            }, { backend });
+            return {
+                vault: options.vault,
+                query: result.query,
+                filters: {
+                    text,
+                    backend,
+                    recordTypes,
+                    kinds,
+                    streams,
+                    experiment: options.experiment ?? null,
+                    from: options.from ?? null,
+                    to: options.to ?? null,
+                    tags,
+                    limit: options.limit,
+                },
+                total: result.total,
+                hits: result.hits,
+            };
+        },
+    });
+    const index = Cli.create('index', {
+        description: 'Inspect and rebuild the optional SQLite lexical search index.',
+    });
+    index.command('status', {
+        description: 'Show the current SQLite lexical search index status.',
+        args: emptyArgsSchema,
+        options: withBaseOptions(),
+        output: searchIndexStatusSchema,
+        async run({ options }) {
+            const query = await loadQueryRuntime();
+            const status = query.getSqliteSearchStatus(options.vault);
+            return {
+                vault: options.vault,
+                ...status,
+            };
+        },
+    });
+    index.command('rebuild', {
+        description: 'Rebuild the SQLite lexical search index from the current read model.',
+        args: emptyArgsSchema,
+        options: withBaseOptions(),
+        output: searchIndexRebuildSchema,
+        async run({ options }) {
+            const query = await loadQueryRuntime();
+            const rebuilt = await query.rebuildSqliteSearchIndex(options.vault);
+            return {
+                vault: options.vault,
+                ...rebuilt,
+            };
+        },
+    });
+    search.command(index);
+    cli.command(search);
+    cli.command('timeline', {
+        description: 'Build a descending timeline from journals, events, assessments, health history, profile snapshots, and daily sample summaries.',
+        args: emptyArgsSchema,
+        options: withBaseOptions({
+            from: localDateSchema
+                .optional()
+                .describe('Inclusive lower date bound.'),
+            to: localDateSchema
+                .optional()
+                .describe('Inclusive upper date bound.'),
+            experiment: slugSchema
+                .optional()
+                .describe('Optional experiment slug filter.'),
+            kind: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Optional entry kinds such as meal, note, journal_day, or sample_summary. Repeat --kind for multiple values.'),
+            stream: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Optional streams; applies to sample summaries and any stream-carrying events. Repeat --stream for multiple values.'),
+            entryType: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Optional entry types: journal, event, assessment, history, profile_snapshot, sample_summary. Repeat --entry-type for multiple values.'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(500)
+                .default(200)
+                .describe('Maximum number of timeline entries to return.'),
+        }),
+        output: timelineResultSchema,
+        async run({ options }) {
+            const kinds = normalizeRepeatableFlagOption(options.kind, 'kind') ?? [];
+            const streams = normalizeRepeatableFlagOption(options.stream, 'stream') ?? [];
+            const entryTypes = normalizeRepeatableEnumFlagOption(options.entryType, 'entry-type', timelineEntryTypeValues) ?? [];
+            const entryTypeSet = entryTypes.length > 0 ? new Set(entryTypes) : null;
+            const query = await loadQueryRuntime();
+            const vault = await query.readVault(options.vault);
+            const items = query.buildTimeline(vault, {
+                from: options.from,
+                to: options.to,
+                experimentSlug: options.experiment,
+                kinds: kinds.length > 0 ? kinds : undefined,
+                streams: streams.length > 0 ? streams : undefined,
+                includeJournal: entryTypeSet ? entryTypeSet.has('journal') : true,
+                includeEvents: entryTypeSet ? entryTypeSet.has('event') : true,
+                includeAssessments: entryTypeSet ? entryTypeSet.has('assessment') : true,
+                includeHistory: entryTypeSet ? entryTypeSet.has('history') : true,
+                includeProfileSnapshots: entryTypeSet
+                    ? entryTypeSet.has('profile_snapshot')
+                    : true,
+                includeDailySampleSummaries: entryTypeSet
+                    ? entryTypeSet.has('sample_summary')
+                    : true,
+                limit: options.limit,
+            });
+            return {
+                vault: options.vault,
+                filters: {
+                    from: options.from ?? null,
+                    to: options.to ?? null,
+                    experiment: options.experiment ?? null,
+                    kinds,
+                    streams,
+                    entryTypes,
+                    limit: options.limit,
+                },
+                items: items,
+            };
+        },
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

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

package/dist/commands/supplement.d.ts

@@ -0,0 +1,4 @@
+import { Cli } from "incur";
+import type { VaultServices } from "@murphai/assistant-core/vault-services";
+export declare function registerSupplementCommands(cli: Cli.Cli, services: VaultServices): void;
+//# sourceMappingURL=supplement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supplement.d.ts","sourceRoot":"","sources":["../../src/commands/supplement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAK,MAAM,OAAO,CAAA;AAY9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAiF3E,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,QAAQ,EAAE,aAAa,QA6QxB"}

package/dist/commands/supplement.js

@@ -0,0 +1,338 @@
+import { Cli, z } from "incur";
+import { requestIdFromOptions, withBaseOptions } from "@murphai/assistant-core/command-helpers";
+import { createHealthScaffoldResultSchema, healthListResultSchema, healthShowResultSchema, } from "@murphai/assistant-core/health-cli-descriptors";
+import { createRegistryDocEntityGroup, suggestedCommandsCta, } from "./health-command-factory.js";
+import { localDateSchema, pathSchema } from "@murphai/assistant-core/vault-cli-contracts";
+const limitOptionSchema = z.number().int().positive().max(200).default(50);
+const supplementSlugSchema = z
+    .string()
+    .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/u, 'Expected a lowercase kebab-case slug.');
+const statusOptionSchema = z
+    .string()
+    .min(1)
+    .optional()
+    .describe('Optional supplement status to filter by.');
+const compoundStatusOptionSchema = z
+    .string()
+    .min(1)
+    .optional()
+    .describe('Optional supplement status to filter by. Defaults to active for compound rollups.');
+const supplementUpsertResultSchema = z.object({
+    vault: pathSchema,
+    protocolId: z.string().min(1),
+    lookupId: z.string().min(1),
+    path: pathSchema.optional(),
+    created: z.boolean(),
+});
+const stopResultSchema = z.object({
+    vault: pathSchema,
+    protocolId: z.string().min(1),
+    lookupId: z.string().min(1),
+    stoppedOn: localDateSchema.nullable(),
+    status: z.string().min(1),
+});
+const compoundSourceSchema = z.object({
+    supplementId: z.string().min(1),
+    supplementSlug: z.string().min(1),
+    supplementTitle: z.string().nullable(),
+    brand: z.string().nullable(),
+    manufacturer: z.string().nullable(),
+    status: z.string().nullable(),
+    label: z.string().nullable(),
+    amount: z.number().nonnegative().nullable(),
+    unit: z.string().nullable(),
+    note: z.string().nullable(),
+});
+const compoundTotalSchema = z.object({
+    unit: z.string().nullable(),
+    totalAmount: z.number().nonnegative().nullable(),
+    sourceCount: z.number().int().nonnegative(),
+    incomplete: z.boolean(),
+});
+const compoundRecordSchema = z.object({
+    compound: z.string().min(1),
+    lookupId: z.string().min(1),
+    totals: z.array(compoundTotalSchema),
+    supplementCount: z.number().int().nonnegative(),
+    supplementIds: z.array(z.string().min(1)),
+    sources: z.array(compoundSourceSchema),
+});
+const compoundFiltersSchema = z.object({
+    status: z.string().min(1),
+    limit: z.number().int().positive().max(200).optional(),
+});
+const compoundShowResultSchema = z.object({
+    vault: pathSchema,
+    filters: compoundFiltersSchema,
+    compound: compoundRecordSchema,
+});
+const compoundListResultSchema = z.object({
+    vault: pathSchema,
+    filters: compoundFiltersSchema,
+    items: z.array(compoundRecordSchema),
+    count: z.number().int().nonnegative(),
+    nextCursor: z.string().min(1).nullable(),
+});
+export function registerSupplementCommands(cli, services) {
+    const supplement = createRegistryDocEntityGroup({
+        commandName: 'supplement',
+        description: 'Supplement product commands plus a derived active-compound ledger.',
+        scaffold: {
+            name: 'scaffold',
+            args: z.object({}),
+            description: 'Emit a payload template for one supplement product.',
+            examples: [
+                {
+                    description: 'Print a template supplement payload.',
+                    options: {
+                        vault: './vault',
+                    },
+                },
+            ],
+            hint: 'The supplement payload supports product metadata plus an ingredients array for compound rollups.',
+            output: createHealthScaffoldResultSchema('supplement'),
+            async run({ options, requestId }) {
+                return services.core.scaffoldSupplement({
+                    vault: options.vault,
+                    requestId,
+                });
+            },
+        },
+        upsert: {
+            description: 'Upsert one supplement from a JSON payload file or stdin.',
+            examples: [
+                {
+                    description: 'Upsert one supplement product from a JSON payload file.',
+                    options: {
+                        input: '@supplement.json',
+                        vault: './vault',
+                    },
+                },
+            ],
+            hint: '--input accepts @file.json or - so the CLI can load a supplement payload with product metadata and ingredients.',
+            output: supplementUpsertResultSchema,
+            async run(input) {
+                return services.core.upsertSupplement(input);
+            },
+        },
+        show: {
+            argName: 'id',
+            argSchema: z.string().min(1),
+            description: 'Show one supplement by canonical id or slug.',
+            examples: [
+                {
+                    args: {
+                        id: '<supplement-id>',
+                    },
+                    description: 'Show one saved supplement product.',
+                    options: {
+                        vault: './vault',
+                    },
+                },
+            ],
+            hint: 'Use the canonical supplement id or the supplement slug.',
+            output: healthShowResultSchema,
+            async run(input) {
+                return services.query.showSupplement(input);
+            },
+        },
+        list: {
+            description: 'List supplements through the health read model.',
+            examples: [
+                {
+                    description: 'List active supplements with a smaller page size.',
+                    options: {
+                        limit: 10,
+                        status: 'active',
+                        vault: './vault',
+                    },
+                },
+            ],
+            hint: 'Use --status active to focus on current supplements or --limit to cap results.',
+            output: healthListResultSchema,
+            statusOption: statusOptionSchema,
+            async run(input) {
+                return services.query.listSupplements({
+                    ...input,
+                    limit: input.limit ?? 50,
+                });
+            },
+        },
+    });
+    supplement.command('stop', {
+        args: z.object({
+            protocolId: z.string().min(1),
+        }),
+        description: 'Stop one supplement while preserving its canonical id.',
+        examples: [
+            {
+                args: {
+                    protocolId: '<supplement-id>',
+                },
+                description: 'Stop a supplement today.',
+                options: {
+                    vault: './vault',
+                },
+            },
+            {
+                args: {
+                    protocolId: '<supplement-id>',
+                },
+                description: 'Stop a supplement on a specific calendar day.',
+                options: {
+                    stoppedOn: '2026-03-12',
+                    vault: './vault',
+                },
+            },
+        ],
+        hint: 'Use the canonical supplement id so the stop event is attached to the existing supplement record.',
+        options: withBaseOptions({
+            stoppedOn: localDateSchema.optional(),
+        }),
+        output: stopResultSchema,
+        async run(context) {
+            const result = await services.core.stopSupplement({
+                protocolId: context.args.protocolId,
+                stoppedOn: context.options.stoppedOn,
+                vault: context.options.vault,
+                requestId: requestIdFromOptions(context.options),
+            });
+            return context.ok(result, {
+                cta: suggestedCommandsCta([
+                    {
+                        command: 'supplement show',
+                        args: {
+                            id: context.args.protocolId,
+                        },
+                        description: 'Show the stopped supplement record.',
+                        options: {
+                            vault: true,
+                        },
+                    },
+                    {
+                        command: 'supplement list',
+                        description: 'List stopped supplements.',
+                        options: {
+                            status: 'stopped',
+                            vault: true,
+                        },
+                    },
+                ]),
+            });
+        },
+    });
+    supplement.command('rename', {
+        args: z.object({
+            lookup: z.string().min(1).describe('Supplement id or slug to rename.'),
+        }),
+        description: 'Rename one supplement product while preserving its canonical id.',
+        examples: [
+            {
+                args: {
+                    lookup: '<supplement-id>',
+                },
+                description: 'Rename a supplement and let the slug move with the new title.',
+                options: {
+                    title: 'Morning Protein Drink',
+                    vault: './vault',
+                },
+            },
+        ],
+        hint: 'Use the canonical supplement id or current slug; the CLI reuses the existing supplement record instead of creating a new one.',
+        options: withBaseOptions({
+            title: z.string().min(1).max(160).describe('New supplement title.'),
+            slug: supplementSlugSchema
+                .optional()
+                .describe('Optional stable slug override for the renamed supplement record.'),
+        }),
+        output: supplementUpsertResultSchema,
+        async run(context) {
+            return services.core.renameSupplement({
+                lookup: context.args.lookup,
+                title: context.options.title,
+                slug: context.options.slug,
+                vault: context.options.vault,
+                requestId: requestIdFromOptions(context.options),
+            });
+        },
+    });
+    const compound = Cli.create('compound', {
+        description: 'Derived canonical ledger of active compounds across supplements.',
+    });
+    compound.command('list', {
+        args: z.object({}),
+        description: 'List rolled-up supplement compounds across supplements.',
+        examples: [
+            {
+                description: 'List active compounds from current supplements.',
+                options: {
+                    vault: './vault',
+                },
+            },
+            {
+                description: 'List stopped-supplement compounds with a smaller page size.',
+                options: {
+                    limit: 10,
+                    status: 'stopped',
+                    vault: './vault',
+                },
+            },
+        ],
+        hint: 'The compound ledger defaults to active supplements so overlapping ingredients sum into a single canonical row.',
+        options: withBaseOptions({
+            limit: limitOptionSchema,
+            status: compoundStatusOptionSchema,
+        }),
+        output: compoundListResultSchema,
+        async run(context) {
+            return services.query.listSupplementCompounds({
+                limit: context.options.limit,
+                status: context.options.status,
+                vault: context.options.vault,
+                requestId: requestIdFromOptions(context.options),
+            });
+        },
+    });
+    compound.command('show', {
+        args: z.object({
+            compound: z.string().min(1),
+        }),
+        description: 'Show one rolled-up supplement compound by name or lookup id.',
+        examples: [
+            {
+                args: {
+                    compound: 'vitamin-c',
+                },
+                description: 'Show one rolled-up compound by lookup id.',
+                options: {
+                    vault: './vault',
+                },
+            },
+            {
+                args: {
+                    compound: 'Magnesium',
+                },
+                description: 'Show one rolled-up compound by display name.',
+                options: {
+                    vault: './vault',
+                },
+            },
+        ],
+        hint: 'Lookup ids are kebab-cased compound names derived from the canonical compound field.',
+        options: withBaseOptions({
+            status: compoundStatusOptionSchema,
+        }),
+        output: compoundShowResultSchema,
+        async run(context) {
+            return services.query.showSupplementCompound({
+                compound: context.args.compound,
+                status: context.options.status,
+                vault: context.options.vault,
+                requestId: requestIdFromOptions(context.options),
+            });
+        },
+    });
+    supplement.command(compound);
+    cli.command(supplement);
+}
+//# sourceMappingURL=supplement.js.map