@parall/cli 1.33.0 → 1.35.0

package/dist/commands/wiki.js

@@ -33,10 +33,10 @@ export function registerWikiCommands(program) {
         .command('sync')
         .description('Sync wiki files to local workspace. First run downloads all files; subsequent runs pull updates.')
         .argument('[wiki]', 'Wiki ID or slug (omit to sync all wikis)')
-        .action(async (_wiki) => {
+        .action(async (wikiRef) => {
         try {
             const ctx = resolveCredentials();
-            const result = await syncAllMounts(ctx);
+            const result = await syncAllMounts(ctx, wikiRef);
             for (const entry of result.synced) {
                 process.stderr.write(`wiki ${entry.slug} synced → ${entry.path}\n`);
             }
@@ -55,22 +55,21 @@ export function registerWikiCommands(program) {
     });
     wiki
         .command('status')
-        .description('Show local changes, pending changesets, and permission summary.')
+        .description('Show local changes and pending changesets.')
         .argument('[wiki]', 'Wiki ID or slug (auto-resolves if org has one wiki)')
         .action(async (wikiRef) => {
         try {
             const ctx = resolveCredentials();
             const result = await getAfcsStatus(ctx, wikiRef);
             process.stderr.write(`Wiki: ${result.wiki_name} (${result.wiki_slug})\n`);
-            process.stderr.write(`Mount: ${result.mount_path}\n`);
-            process.stderr.write(`Mode: ${result.mode}\n\n`);
+            process.stderr.write(`Mount: ${result.mount_path}\n\n`);
             if (result.local_changes.length === 0) {
                 process.stderr.write('Local changes: none\n');
             }
             else {
                 process.stderr.write('Local changes:\n');
                 for (const file of result.local_changes) {
-                    const s = file.additions > 0 && file.deletions > 0 ? 'M' : file.additions > 0 ? 'A' : 'D';
+                    const s = file.action === 'create' ? 'A' : file.action === 'delete' ? 'D' : 'M';
                     process.stderr.write(`  ${s} ${file.path} (+${file.additions} -${file.deletions})\n`);
                 }
             }
@@ -87,11 +86,6 @@ export function registerWikiCommands(program) {
                     }
                 }
             }
-            if (result.permissions) {
-                process.stderr.write('\nPermissions:\n');
-                process.stderr.write(`  Read:  ${result.permissions.readable_prefixes.join(', ')}\n`);
-                process.stderr.write(`  Write: ${result.permissions.writable_prefixes.join(', ') || 'none'}\n`);
-            }
             printJson(result);
         }
         catch (error) {
@@ -121,7 +115,7 @@ export function registerWikiCommands(program) {
     });
     wiki
         .command('reset')
-        .description('Discard all local changes and restore files to the last synced state (re-downloads from server).')
+        .description('Discard all local changes and restore files to the last synced state.')
         .argument('[wiki]', 'Wiki ID or slug (auto-resolves if org has one wiki)')
         .action(async (wikiRef) => {
         try {
@@ -134,6 +128,23 @@ export function registerWikiCommands(program) {
             printError(error);
         }
     });
+    wiki
+        .command('access')
+        .description('Show your access level (read / maintain / admin) for a wiki path')
+        .argument('<path>', 'Path to check (e.g. docs/ops/)')
+        .argument('[wiki]', 'Wiki ID or slug (auto-resolves if org has one wiki)')
+        .action(async (targetPath, wikiRef) => {
+        try {
+            const ctx = resolveCredentials();
+            const { resolveWikiRefOrDefault } = await import('../lib/wiki.js');
+            const wiki = await resolveWikiRefOrDefault(ctx, wikiRef);
+            const result = await ctx.client.getWikiAccessStatus(ctx.orgId, wiki.id, targetPath);
+            printJson(result);
+        }
+        catch (error) {
+            printError(error);
+        }
+    });
     wiki
         .command('request-access')
         .description('Request read/write access to a locked wiki path. Creates an approval card for a maintainer.')
@@ -153,9 +164,9 @@ export function registerWikiCommands(program) {
     });
     wiki
         .command('log')
-        .description('Show version history. With a path: per-file history. Without: recent operations.')
+        .description("Show history. With a path: that file's commit history. Without: recent wiki operations.")
         .argument('[wiki]', 'Wiki ID or slug (auto-resolves if org has one wiki)')
-        .argument('[path]', 'File path for per-file history')
+        .argument('[path]', 'File path for per-file commit history')
         .action(async (wikiRef, filePath) => {
         try {
             const ctx = resolveCredentials();
@@ -166,7 +177,8 @@ export function registerWikiCommands(program) {
             else {
                 for (const entry of result.entries) {
                     const pathSuffix = entry.path ? ` ${entry.path}` : '';
-                    process.stderr.write(`${entry.id.slice(0, 8)}  ${entry.created_at}  ${entry.action}${pathSuffix}\n`);
+                    const who = entry.author_name ?? entry.actor_id ?? '';
+                    process.stderr.write(`${entry.id.slice(0, 8)}  ${entry.created_at}  ${entry.action}${who ? `  (${who})` : ''}${pathSuffix}\n`);
                 }
             }
             printJson(result);
@@ -345,7 +357,7 @@ export function registerWikiCommands(program) {
     // ---- Content browsing (search, query, outline, section) ----
     wiki
         .command('search')
-        .description('Search wiki content by keyword')
+        .description('Keyword search over wiki sections. Searches your local workspace copy when synced; otherwise fetches from the server.')
         .argument('<query>', 'Search query')
         .argument('[wiki]', 'Wiki ID or slug')
         .option('--path <path>', 'Restrict to a path prefix')
@@ -377,8 +389,8 @@ export function registerWikiCommands(program) {
     });
     wiki
         .command('query')
-        .description('Tree-aware structured query over wiki sections')
-        .argument('<query>', 'Natural-language query')
+        .description('Heading-aware keyword search that also ranks whole documents. Same lexical scoring as `search` (not semantic), better for multi-word questions.')
+        .argument('<query>', 'Query keywords (multi-word supported)')
         .argument('[wiki]', 'Wiki ID or slug')
         .option('--path <path>', 'Restrict to a path prefix')
         .option('--limit <n>', 'Max results (default 5)')
@@ -453,14 +465,18 @@ export function registerWikiCommands(program) {
     });
     wiki
         .command('cat')
-        .description('Read a wiki page by file path (raw markdown content)')
+        .description('Print a wiki file. Reads your local workspace copy when synced (includes your unproposed edits); falls back to the server.')
         .argument('<path>', 'File path (e.g. docs/auth.md)')
         .argument('[wiki]', 'Wiki ID or slug')
-        .action(async (filePath, wikiRef) => {
+        .option('--remote', 'Read the server version even when a local workspace copy exists')
+        .action(async (filePath, wikiRef, options) => {
         try {
             const ctx = resolveCredentials();
-            const result = await getWikiBlob(ctx, wikiRef, { path: filePath });
-            process.stderr.write(`${filePath}  (${result.size} bytes)\n\n`);
+            const result = await getWikiBlob(ctx, wikiRef, {
+                path: filePath,
+                remote: options.remote,
+            });
+            process.stderr.write(`${filePath}  (${result.size} bytes, source: ${result.source})\n\n`);
             process.stdout.write(result.content);
             if (result.content && !result.content.endsWith('\n'))
                 process.stdout.write('\n');

package/dist/lib/wiki-frontmatter.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedFrontMatter {
+    type?: string;
+    description?: string;
+    tags?: string[];
+}
+/** True when any OKF field was extracted. */
+export declare function hasFrontMatter(fm: ParsedFrontMatter): boolean;
+export declare function parseFrontMatter(lines: string[], frontMatterEnd: number): ParsedFrontMatter;
+//# sourceMappingURL=wiki-frontmatter.d.ts.map

package/dist/lib/wiki-frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-frontmatter.d.ts","sourceRoot":"","sources":["../../src/lib/wiki-frontmatter.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAE7D;AAQD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,iBAAiB,CAyB3F"}

package/dist/lib/wiki-frontmatter.js

@@ -0,0 +1,64 @@
+// Frontmatter (OKF-inspired) parsing for wiki markdown files.
+//
+// This mirrors the Go implementation in server/pkg/markdown/section.go — keep
+// the two behaviorally consistent. It lives in its own module (rather than
+// growing the already-oversized wiki.ts) per the repo's file-size discipline.
+import { load as loadYaml } from 'js-yaml';
+/** True when any OKF field was extracted. */
+export function hasFrontMatter(fm) {
+    return fm.type !== undefined || fm.description !== undefined || fm.tags !== undefined;
+}
+// parseFrontMatter extracts the optional OKF fields (type, description, tags)
+// from the leading YAML frontmatter block. Permissive by design: only
+// `---`-delimited YAML is parsed (a `+++` TOML block is detected for section
+// boundaries by detectFrontMatterEnd but its fields are not extracted); any
+// parse error / missing field / wrong-typed value degrades to undefined so a
+// malformed field never discards a valid one.
+export function parseFrontMatter(lines, frontMatterEnd) {
+    // frontMatterEnd is one past the closing fence; opening fence is line 0 and
+    // the closing fence is line frontMatterEnd-1, so a block needs >= 2 lines.
+    if (frontMatterEnd < 2 || lines.length === 0) {
+        return {};
+    }
+    if (lines[0].trim() !== '---') {
+        return {}; // only YAML frontmatter carries OKF fields
+    }
+    const body = lines.slice(1, frontMatterEnd - 1).join('\n');
+    let raw;
+    try {
+        raw = loadYaml(body);
+    }
+    catch {
+        return {};
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        return {};
+    }
+    const obj = raw;
+    return {
+        type: frontMatterString(obj.type),
+        description: frontMatterString(obj.description),
+        tags: frontMatterTags(obj.tags),
+    };
+}
+function frontMatterString(v) {
+    if (typeof v !== 'string') {
+        return undefined;
+    }
+    const s = v.trim();
+    return s === '' ? undefined : s;
+}
+function frontMatterTags(v) {
+    if (typeof v === 'string') {
+        const s = v.trim();
+        return s === '' ? undefined : [s];
+    }
+    if (Array.isArray(v)) {
+        const out = v
+            .filter((e) => typeof e === 'string')
+            .map((e) => e.trim())
+            .filter((e) => e !== '');
+        return out.length > 0 ? out : undefined;
+    }
+    return undefined;
+}

package/dist/lib/wiki-tools.d.ts

@@ -0,0 +1,33 @@
+import * as z from 'zod/v4';
+import { type ParallContext } from './wiki.js';
+/**
+ * Shared Parall wiki native tool registry.
+ *
+ * Single source of truth for the wiki tool surface consumed by:
+ * - the MCP server (`commands/mcp.ts`), which registers each definition
+ * - the eval harness (`@parall/eval`), which benchmarks the real tools
+ *
+ * Keep the schemas and handlers here behavior-identical to what the MCP
+ * server used to define inline. Do not fork an eval-only clone.
+ */
+export type WikiToolExecutionResult = {
+    structuredContent: Record<string, unknown>;
+    text: string;
+};
+export type WikiToolDefinition = {
+    name: string;
+    title: string;
+    description: string;
+    readOnly: boolean;
+    inputSchema: z.ZodRawShape;
+    outputSchema: z.ZodRawShape;
+    handler: (args: Record<string, unknown>) => Promise<WikiToolExecutionResult>;
+};
+/**
+ * Build the full wiki native tool registry bound to a Parall context (credentials,
+ * agent env, local mount). Returns one definition per wiki capability (list, tree,
+ * status, diff, blob, search, query, outline, section, changeset diff, propose),
+ * each finalized with input validation. Shared by the MCP server and the eval harness.
+ */
+export declare function buildWikiTools(ctx: ParallContext): WikiToolDefinition[];
+//# sourceMappingURL=wiki-tools.d.ts.map

package/dist/lib/wiki-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-tools.d.ts","sourceRoot":"","sources":["../../src/lib/wiki-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EASL,KAAK,aAAa,EAInB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;GASG;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,YAAY,EAAE,CAAC,CAAC,WAAW,CAAC;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC9E,CAAC;AAoBF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,kBAAkB,EAAE,CAiiBvE"}