@murphai/murph 0.1.1 → 0.1.13

package/dist/commands/knowledge.js

@@ -0,0 +1,164 @@
+import { Cli, z } from 'incur';
+import { emptyArgsSchema, withBaseOptions, } from '@murphai/assistant-core/command-helpers';
+import { pathSchema, slugSchema, } from '@murphai/assistant-core/vault-cli-contracts';
+import { knowledgeCompileResultSchema, knowledgeIndexRebuildResultSchema, knowledgeLintResultSchema, knowledgeListResultSchema, knowledgeSearchResultSchema, knowledgeShowResultSchema, } from '../knowledge-cli-contracts.js';
+import { compileKnowledgePage, lintKnowledgePages, listKnowledgePages, rebuildKnowledgeIndex, searchKnowledgePages, showKnowledgePage, } from '../knowledge-runtime.js';
+export function registerKnowledgeCommands(cli) {
+    const knowledge = Cli.create('knowledge', {
+        description: 'Compile and inspect Murph\'s non-canonical derived knowledge wiki under derived/knowledge/**.',
+    });
+    knowledge.command('compile', {
+        description: 'Persist one assistant-authored derived knowledge page from local vault context and rebuild the knowledge index.',
+        args: z.object({
+            prompt: z
+                .string()
+                .min(1)
+                .describe('What the knowledge page should explain, synthesize, or update.'),
+        }),
+        options: withBaseOptions({
+            body: z
+                .string()
+                .min(1)
+                .describe('Assistant-authored markdown body for the page. Do not include YAML frontmatter; Murph normalizes the title heading and sources section.'),
+            title: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional page title override.'),
+            slug: slugSchema
+                .optional()
+                .describe('Optional stable page slug. Defaults to a slugified title/prompt.'),
+            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.'),
+            sourcePath: z
+                .array(pathSchema)
+                .optional()
+                .describe('Optional vault-relative paths, or absolute 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: knowledgeCompileResultSchema,
+        run({ args, options }) {
+            return compileKnowledgePage({
+                vault: options.vault,
+                body: options.body,
+                prompt: args.prompt,
+                title: options.title,
+                slug: options.slug,
+                pageType: options.pageType,
+                status: options.status,
+                sourcePaths: options.sourcePath,
+            });
+        },
+    });
+    knowledge.command('list', {
+        description: 'List derived knowledge pages currently compiled 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 compiled 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 showKnowledgePage({
+                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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"}