@murphai/murph 0.1.1 → 0.1.14

package/dist/commands/knowledge.js

@@ -0,0 +1,163 @@
+import { Cli, z } from 'incur';
+import { emptyArgsSchema, withBaseOptions, } from '@murphai/assistant-core/command-helpers';
+import { getKnowledgePage, lintKnowledgePages, listKnowledgePages, rebuildKnowledgeIndex, searchKnowledgePages, upsertKnowledgePage, } from '@murphai/assistant-core/knowledge';
+import { pathSchema, slugSchema, } from '@murphai/assistant-core/vault-cli-contracts';
+import { knowledgeIndexRebuildResultSchema, knowledgeLintResultSchema, knowledgeListResultSchema, knowledgeSearchResultSchema, knowledgeShowResultSchema, knowledgeUpsertResultSchema, } from '../knowledge-cli-contracts.js';
+export function registerKnowledgeCommands(cli) {
+    const knowledge = Cli.create('knowledge', {
+        description: 'Manage and inspect Murph\'s non-canonical derived knowledge wiki under derived/knowledge/**.',
+    });
+    knowledge.command('upsert', {
+        description: 'Persist one assistant-authored derived knowledge page from local vault context and rebuild the knowledge index.',
+        args: emptyArgsSchema,
+        options: withBaseOptions({
+            body: z
+                .string()
+                .min(1)
+                .describe('Assistant-authored markdown body for the page. Do not include YAML frontmatter; Murph normalizes the heading plus generated related and sources sections.'),
+            title: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional page title override.'),
+            slug: slugSchema
+                .optional()
+                .describe('Optional stable page slug. Defaults to a slugified title or H1 heading.'),
+            pageType: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional freeform page type such as concept, pattern, or protocol.'),
+            status: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional page status such as active, draft, or archived.'),
+            relatedSlug: z
+                .array(slugSchema)
+                .optional()
+                .describe('Optional explicit related page slugs. Repeat --related-slug to add more; Murph also derives related slugs from body wikilinks.'),
+            sourcePath: z
+                .array(pathSchema)
+                .optional()
+                .describe('Optional vault-relative source file paths, or absolute source file paths that still resolve inside the selected vault. Repeat --source-path to include multiple files. Derived/runtime paths such as derived/** and .runtime/** are rejected.'),
+        }),
+        output: knowledgeUpsertResultSchema,
+        run({ options }) {
+            return upsertKnowledgePage({
+                vault: options.vault,
+                body: options.body,
+                title: options.title,
+                slug: options.slug,
+                pageType: options.pageType,
+                relatedSlugs: options.relatedSlug,
+                status: options.status,
+                sourcePaths: options.sourcePath,
+            });
+        },
+    });
+    knowledge.command('list', {
+        description: 'List derived knowledge pages currently saved under derived/knowledge/pages/**.',
+        args: emptyArgsSchema,
+        options: withBaseOptions({
+            pageType: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional page-type filter.'),
+            status: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional status filter.'),
+        }),
+        output: knowledgeListResultSchema,
+        run({ options }) {
+            return listKnowledgePages({
+                vault: options.vault,
+                pageType: options.pageType,
+                status: options.status,
+            });
+        },
+    });
+    knowledge.command('search', {
+        description: 'Search derived knowledge pages by lexical match across titles, summaries, body text, related slugs, and source paths.',
+        args: z.object({
+            query: z
+                .string()
+                .min(1)
+                .describe('Search query for the saved knowledge wiki.'),
+        }),
+        options: withBaseOptions({
+            pageType: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional page-type filter.'),
+            status: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional status filter.'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(200)
+                .optional()
+                .describe('Optional result limit. Defaults to 20 and is capped at 200.'),
+        }),
+        output: knowledgeSearchResultSchema,
+        run({ args, options }) {
+            return searchKnowledgePages({
+                vault: options.vault,
+                query: args.query,
+                limit: options.limit,
+                pageType: options.pageType,
+                status: options.status,
+            });
+        },
+    });
+    knowledge.command('show', {
+        description: 'Show one derived knowledge page by slug.',
+        args: z.object({
+            slug: slugSchema.describe('Knowledge page slug to inspect.'),
+        }),
+        options: withBaseOptions(),
+        output: knowledgeShowResultSchema,
+        run({ args, options }) {
+            return getKnowledgePage({
+                vault: options.vault,
+                slug: args.slug,
+            });
+        },
+    });
+    knowledge.command('lint', {
+        description: 'Run deterministic health checks over derived knowledge pages: missing sources, missing related pages, parse failures, and other structural problems.',
+        args: emptyArgsSchema,
+        options: withBaseOptions(),
+        output: knowledgeLintResultSchema,
+        run({ options }) {
+            return lintKnowledgePages({
+                vault: options.vault,
+            });
+        },
+    });
+    const index = Cli.create('index', {
+        description: 'Rebuild the derived knowledge markdown index.',
+    });
+    index.command('rebuild', {
+        description: 'Rebuild derived/knowledge/index.md from the current knowledge pages.',
+        args: emptyArgsSchema,
+        options: withBaseOptions(),
+        output: knowledgeIndexRebuildResultSchema,
+        run({ options }) {
+            return rebuildKnowledgeIndex({
+                vault: options.vault,
+            });
+        },
+    });
+    knowledge.command(index);
+    cli.command(knowledge);
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/commands/knowledge.js.map

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