@ekanos/cli 0.12.0 → 0.14.0

package/dist/commands/knowledge.d.ts

@@ -0,0 +1,56 @@
+import type { CliContext } from '../context.js';
+import type { ExitCode } from '../exit-codes.js';
+import { type KnowledgePushArticle } from '../knowledge-api.js';
+export declare const KNOWLEDGE_SUBCOMMANDS: readonly ['list', 'push', 'search', 'pull'];
+export interface KnowledgeArgs {
+    host?: string;
+    source?: string;
+    subcommand?: string;
+    /** `push <dir>`, `search <query>`. */
+    target?: string;
+    /** A team's slug: that team's collection instead of the Source's General one. */
+    team?: string;
+    /** `pull`: where to write (default `knowledge/<team|general>`). */
+    out?: string;
+    /** `pull`: overwrite local files that differ from the host's. */
+    force?: boolean;
+    /**
+     * `push --prune`: also delete the articles an earlier push of this folder
+     * made whose files are gone. Never an article written in the app, and
+     * never one edited there since the push.
+     */
+    prune?: boolean;
+    /** `push --prune`: delete without asking (a script or agent run). */
+    yes?: boolean;
+    dir: string;
+    env: Record<string, string | undefined>;
+    stdinIsTTY?: boolean;
+    confirm?: (question: string) => Promise<boolean>;
+}
+/**
+ * `knowledge` — a Source's Knowledge base (plan 244): the General collection
+ * every team reads, and with `--team` one team's own collection. `push`
+ * turns a folder of markdown files into articles — one per `.md`, keyed by
+ * its path, so pushing the same folder again only changes what changed —
+ * and `pull` writes them back the same way. `search` runs as a team's
+ * agents do: that team's articles plus General.
+ */
+export declare function runKnowledge(ctx: CliContext, args: KnowledgeArgs): Promise<ExitCode>;
+/**
+ * Which folder a push came from, as the host records it on each article
+ * (`synced_from`): the path as named from the project directory, so pushing
+ * the same folder from the same place is the same origin. `--prune` only
+ * ever removes articles of that origin.
+ */
+export declare function knowledgeOrigin(target: string, cwd: string): string;
+/** Mirrors the host's `knowledgeSlug`: a file's path without `.md`. */
+export declare function knowledgeSlugFromPath(relative: string): string;
+/**
+ * Every markdown file under `target`, as articles. The title is the
+ * frontmatter `title:`, else the first `# heading` (taken out of the body so
+ * it is not shown twice), else the file name; tags are the frontmatter
+ * `tags:` (`[a, b]`, `a, b` or a `- a` list).
+ */
+export declare function readKnowledgeFolder(target: string, cwd: string): (KnowledgePushArticle & {
+    file: string;
+})[];

package/dist/commands/knowledge.js

@@ -0,0 +1,456 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { loginHint } from '../auth/host-trust.js';
+import { refreshStoredSession, requireSession, resolveAuthEnvironment, } from '../auth/session.js';
+import { authRequiredError, invalidStateError, notFoundError, usageError, validationError, } from '../errors.js';
+import { KNOWLEDGE_PUSH_BATCH, KnowledgeListSchema, KnowledgePruneSchema, KnowledgePushSchema, KnowledgeSearchSchema, isSafeKnowledgeSlug, knowledgeCall, } from '../knowledge-api.js';
+import { writePulledFiles } from '../pull-write.js';
+import { classifyPath } from '../safe-fs.js';
+import { resolveSourceTarget } from '../source-target.js';
+import { pluralize } from '../ui.js';
+import { promptYesNo } from './publish.js';
+export const KNOWLEDGE_SUBCOMMANDS = [
+    'list',
+    'push',
+    'search',
+    'pull',
+];
+const USAGE = 'Run one of: ekanos knowledge list [--team <slug>] | push <dir> [--team <slug>] [--prune [--yes]] | search <query> --team <slug> | pull [--team <slug>] [--out <dir>] [--force].';
+/**
+ * `knowledge` — a Source's Knowledge base (plan 244): the General collection
+ * every team reads, and with `--team` one team's own collection. `push`
+ * turns a folder of markdown files into articles — one per `.md`, keyed by
+ * its path, so pushing the same folder again only changes what changed —
+ * and `pull` writes them back the same way. `search` runs as a team's
+ * agents do: that team's articles plus General.
+ */
+export async function runKnowledge(ctx, args) {
+    var _a;
+    var _b, _c;
+    const subcommand = parseSubcommand(args.subcommand);
+    const team = ((_a = args.team) === null || _a === void 0 ? void 0 : _a.trim()) || undefined;
+    // Read the folder before any network call, so a bad one fails fast.
+    const files = subcommand === 'push'
+        ? readKnowledgeFolder(requireTarget(args.target, 'push'), args.dir)
+        : null;
+    if (args.prune && subcommand !== 'push') {
+        throw usageError('--prune goes with knowledge push.', 'Run "ekanos knowledge push <dir> --prune".');
+    }
+    const origin = subcommand === 'push' ? knowledgeOrigin(args.target, args.dir) : null;
+    if (args.prune &&
+        classifyPath(path.resolve(args.dir, args.target)) !== 'directory') {
+        throw usageError('--prune needs a folder: it removes the articles whose files are gone from it.', 'Pass the folder you push, e.g. "ekanos knowledge push ./knowledge --prune".');
+    }
+    if (subcommand === 'search') {
+        requireTarget(args.target, 'search');
+        if (!team) {
+            throw usageError('knowledge search needs --team <slug>.', 'Search runs as that team’s agents see it: its articles plus the General collection.');
+        }
+    }
+    const env = resolveAuthEnvironment(ctx, args.host, args.env, {
+        projectDir: args.dir,
+    });
+    const resolved = await resolveSourceTarget(env, requireSession(env), args);
+    const client = new KnowledgeClient(env, resolved.session);
+    const source = resolved.source;
+    const send = (schema, init) => client.call((token) => knowledgeCall(env.host, token, schema, init));
+    const where = (slug) => (team ? `team ${team}` : `${slug} General`);
+    switch (subcommand) {
+        case 'list': {
+            const list = await send(KnowledgeListSchema, {
+                method: 'GET',
+                query: { source, team },
+            });
+            if (list.articles.length === 0) {
+                return ctx.succeed(Object.assign({ host: env.host }, list), ctx.ui.result({
+                    title: `No Knowledge articles in ${where(list.source.slug)} yet`,
+                    tone: 'warn',
+                    notes: [
+                        `"ekanos knowledge push <dir>${team ? ` --team ${team}` : ''}" stores a folder of .md files.`,
+                    ],
+                }));
+            }
+            return ctx.succeed(Object.assign({ host: env.host }, list), [
+                ctx.ui.bold(`${pluralize(list.articles.length, 'article')} in ${where(list.source.slug)}`),
+                ctx.ui.table(['Slug', 'Title', 'Tags', 'Version', 'Updated'], list.articles.map((article) => [
+                    article.slug,
+                    article.title,
+                    article.tags.join(', '),
+                    `v${article.version}`,
+                    article.updatedAt.slice(0, 10),
+                ])),
+            ].join('\n'));
+        }
+        case 'search': {
+            const query = args.target;
+            const found = await send(KnowledgeSearchSchema, {
+                method: 'GET',
+                path: '/search',
+                query: { source, team, q: query },
+            });
+            if (found.results.length === 0) {
+                return ctx.succeed(Object.assign({ host: env.host }, found), ctx.ui.result({
+                    title: `Nothing in team ${team}'s Knowledge matches "${query}"`,
+                    tone: 'warn',
+                    notes: ['Try fewer or different words.'],
+                }));
+            }
+            return ctx.succeed(Object.assign({ host: env.host }, found), ctx.ui.result({
+                title: `${found.results.length === 1 ? '1 match' : `${found.results.length} matches`} for "${query}" in team ${team}`,
+                rows: found.results.map((hit) => [
+                    `${hit.title} (${hit.collection === 'general' ? 'General' : 'team'})`,
+                    [hit.snippet.replace(/\s+/g, ' '), ctx.ui.dim(hit.slug)],
+                ]),
+            }));
+        }
+        case 'push': {
+            const articles = files;
+            const keep = articles.map((article) => article.slug);
+            const prune = (deleteSlugs) => send(KnowledgePruneSchema, {
+                method: 'POST',
+                path: '/prune',
+                query: {},
+                body: Object.assign(Object.assign(Object.assign({ source }, (team ? { team } : {})), { origin: origin, keep }), (deleteSlugs ? { delete: deleteSlugs } : {})),
+            });
+            // Ask (or refuse) before anything is written: what would go is known
+            // from the folder alone.
+            const preview = args.prune ? await prune() : null;
+            if (preview && preview.candidates.length > 0) {
+                await confirmPrune(ctx, args, {
+                    candidates: preview.candidates,
+                    where: where(preview.source.slug),
+                    command: `ekanos knowledge push ${args.target}${team ? ` --team ${team}` : ''} --source ${source} --prune --yes`,
+                });
+            }
+            const results = [];
+            let pushed = null;
+            for (let start = 0; start < articles.length; start += KNOWLEDGE_PUSH_BATCH) {
+                const batch = articles.slice(start, start + KNOWLEDGE_PUSH_BATCH);
+                const response = await send(KnowledgePushSchema, {
+                    method: 'POST',
+                    query: {},
+                    body: Object.assign(Object.assign({ source }, (team ? { team } : {})), { origin: origin, articles: batch.map((_a) => {
+                            var { file: _file } = _a, article = __rest(_a, ["file"]);
+                            return article;
+                        }) }),
+                });
+                pushed = response;
+                results.push(...response.results);
+            }
+            const pruned = preview && preview.candidates.length > 0
+                ? await prune(preview.candidates.map((article) => article.slug))
+                : preview;
+            const count = (status) => results.filter((result) => result.status === status).length;
+            const refused = results.filter((result) => result.status === 'refused');
+            const pruneRows = pruned
+                ? [
+                    [
+                        'Pruned',
+                        pruned.deleted.length > 0
+                            ? pruned.deleted.map((article) => article.slug)
+                            : '0',
+                    ],
+                    ...(pruned.edited.length > 0
+                        ? [
+                            [
+                                'Kept',
+                                pruned.edited.map((article) => `${article.slug}: its file is gone, but it was edited in the app since it was pushed`),
+                            ],
+                        ]
+                        : []),
+                ]
+                : [];
+            return ctx.succeed(Object.assign({ host: env.host, team: team !== null && team !== void 0 ? team : null, origin,
+                results }, (pruned
+                ? { pruned: pruned.deleted, keptEdited: pruned.edited }
+                : {})), ctx.ui.result({
+                title: `Pushed ${pluralize(results.length, 'article')} to ${where((_b = pushed === null || pushed === void 0 ? void 0 : pushed.source.slug) !== null && _b !== void 0 ? _b : source)}`,
+                tone: refused.length > 0 ? 'warn' : 'ok',
+                rows: [
+                    ['Created', String(count('created'))],
+                    ['Updated', String(count('updated'))],
+                    ['Unchanged', String(count('unchanged'))],
+                    ...(refused.length > 0
+                        ? [
+                            [
+                                'Refused',
+                                refused.map((result) => { var _a; return `${result.slug}: ${(_a = result.message) !== null && _a !== void 0 ? _a : ''}`; }),
+                            ],
+                        ]
+                        : []),
+                    ...pruneRows,
+                ],
+                notes: [
+                    team
+                        ? `Team ${team}'s agents with search_knowledge find these now.`
+                        : "Every team's agents granted search_knowledge find these now, beside their team's own articles.",
+                ],
+            }));
+        }
+        case 'pull': {
+            const list = await send(KnowledgeListSchema, {
+                method: 'GET',
+                query: { source, team, body: '1' },
+            });
+            const outDir = path.resolve(args.dir, (_c = args.out) !== null && _c !== void 0 ? _c : path.join('knowledge', team !== null && team !== void 0 ? team : 'general'));
+            const written = writePulledFiles({
+                projectDir: args.dir,
+                outDir,
+                files: knowledgeFiles(list.articles),
+                force: args.force === true,
+                rerun: `ekanos knowledge pull${team ? ` --team ${team}` : ''}`,
+            });
+            return ctx.succeed({ host: env.host, team: team !== null && team !== void 0 ? team : null, dir: outDir, files: written }, ctx.ui.result({
+                title: `Pulled ${pluralize(written.length, 'article')} from ${where(list.source.slug)}`,
+                rows: [['Into', outDir]],
+                notes: [
+                    `Edit, then "ekanos knowledge push ${path.relative(args.dir, outDir) || '.'}${team ? ` --team ${team}` : ''}".`,
+                ],
+            }));
+        }
+    }
+}
+/**
+ * Which folder a push came from, as the host records it on each article
+ * (`synced_from`): the path as named from the project directory, so pushing
+ * the same folder from the same place is the same origin. `--prune` only
+ * ever removes articles of that origin.
+ */
+export function knowledgeOrigin(target, cwd) {
+    const relative = path
+        .relative(cwd, path.resolve(cwd, target))
+        .split(path.sep)
+        .join('/');
+    return (relative || '.').slice(-300);
+}
+/**
+ * Pruning deletes articles. A person is asked, listing them; a script or
+ * agent run needs `--yes`, and is refused before anything is written.
+ */
+async function confirmPrune(ctx, args, target) {
+    var _a, _b;
+    if (args.yes)
+        return;
+    const list = target.candidates.map((article) => article.slug);
+    const what = `--prune would delete ${pluralize(list.length, 'article')} from ${target.where} whose files are gone: ${list.join(', ')}`;
+    const canPrompt = !ctx.jsonMode && ((_a = args.stdinIsTTY) !== null && _a !== void 0 ? _a : process.stdin.isTTY === true);
+    if (!canPrompt) {
+        throw invalidStateError(`${what}. Nothing was pushed or deleted.`, `Re-run with --yes: ${target.command}`);
+    }
+    const sure = await ((_b = args.confirm) !== null && _b !== void 0 ? _b : promptYesNo)(`${what}. Delete them? [y/N]`);
+    if (!sure) {
+        throw validationError('Nothing was pushed or deleted.', 'Run it again without --prune to push only.');
+    }
+}
+/** Every call refreshes the session once on a 401, then gives up. */
+class KnowledgeClient {
+    constructor(env, session) {
+        this.env = env;
+        this.session = session;
+    }
+    async call(send) {
+        let result = await send(this.session.accessToken);
+        if (result.status === 'unauthorized') {
+            this.session = await refreshStoredSession(this.env, this.session);
+            result = await send(this.session.accessToken);
+        }
+        if (result.status === 'ok')
+            return result.data;
+        throw authRequiredError(`The session for ${this.env.host} could not authorize the knowledge call.`, loginHint(this.env));
+    }
+}
+/** Mirrors the host's `knowledgeSlug`: a file's path without `.md`. */
+export function knowledgeSlugFromPath(relative) {
+    return relative
+        .trim()
+        .toLowerCase()
+        .replace(/\\/g, '/')
+        .replace(/\.(md|markdown|mdx)$/, '')
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .replace(/[^a-z0-9._/-]+/g, '-')
+        .replace(/\/+/g, '/')
+        .replace(/-{2,}/g, '-')
+        .split('/')
+        .map((part) => part.replace(/^[-.]+|[-.]+$/g, ''))
+        .filter(Boolean)
+        .join('/')
+        .slice(0, 200);
+}
+const IGNORED = new Set(['node_modules', '.git']);
+const MARKDOWN = /\.(md|markdown|mdx)$/i;
+const BODY_MAX = 200000;
+/**
+ * Every markdown file under `target`, as articles. The title is the
+ * frontmatter `title:`, else the first `# heading` (taken out of the body so
+ * it is not shown twice), else the file name; tags are the frontmatter
+ * `tags:` (`[a, b]`, `a, b` or a `- a` list).
+ */
+export function readKnowledgeFolder(target, cwd) {
+    const root = path.resolve(cwd, target);
+    const kind = classifyPath(root);
+    if (kind !== 'directory' && kind !== 'file') {
+        throw notFoundError(`No folder or file at ${root}.`, 'Pass a folder of .md files, e.g. "ekanos knowledge push ./knowledge".');
+    }
+    const found = [];
+    const walk = (dir) => {
+        for (const name of fs.readdirSync(dir).sort()) {
+            if (IGNORED.has(name) || name.startsWith('.'))
+                continue;
+            const full = path.join(dir, name);
+            const entry = classifyPath(full);
+            if (entry === 'directory')
+                walk(full);
+            else if (entry === 'file' && MARKDOWN.test(name))
+                found.push(full);
+        }
+    };
+    if (kind === 'file') {
+        const name = path.basename(root);
+        if (name.startsWith('.') || !MARKDOWN.test(name)) {
+            throw validationError(`${root} is not a markdown file, so it was not pushed.`, 'Pass a .md, .markdown or .mdx file (not a dotfile), or a folder of them.');
+        }
+        found.push(root);
+    }
+    else
+        walk(root);
+    if (found.length === 0) {
+        throw validationError(`No .md files under ${root}.`, 'Each markdown file becomes one article.');
+    }
+    const base = kind === 'file' ? path.dirname(root) : root;
+    const seen = new Map();
+    return found.map((file) => {
+        const relative = path.relative(base, file).split(path.sep).join('/');
+        const markdown = fs.readFileSync(file, 'utf8');
+        const { fields, tags, body } = splitFrontmatter(markdown);
+        const slug = knowledgeSlugFromPath(fields.slug || relative);
+        if (!slug) {
+            throw validationError(`${file}: no usable slug.`, 'Rename the file with letters or digits.');
+        }
+        const clash = seen.get(slug);
+        if (clash) {
+            throw validationError(`${file} and ${clash} both become "${slug}".`, 'Rename one of them.');
+        }
+        seen.set(slug, file);
+        const heading = fields.title
+            ? null
+            : body.match(/^[ \t]*#[ \t]+(.+?)[ \t]*#*[ \t]*$/m);
+        const title = (fields.title ||
+            (heading === null || heading === void 0 ? void 0 : heading[1]) ||
+            path.basename(file).replace(MARKDOWN, '').replace(/[-_]+/g, ' '))
+            .trim()
+            .slice(0, 300);
+        const text = (heading ? body.replace(heading[0], '') : body).replace(/^\s*\n/, '');
+        if (text.length > BODY_MAX) {
+            throw validationError(`${file} is longer than ${BODY_MAX.toLocaleString()} characters.`, 'Split it into smaller articles.');
+        }
+        return Object.assign({ file,
+            slug, title: title || slug, body: text }, (tags.length > 0 ? { tags: tags.slice(0, 30) } : {}));
+    });
+}
+/** One `.md` per article: its title and tags as frontmatter, then the body. */
+function knowledgeFiles(articles) {
+    const unsafe = articles.filter((article) => !isSafeKnowledgeSlug(article.slug));
+    if (unsafe.length > 0) {
+        throw validationError(`Refusing to pull: the host sent ${unsafe.length === 1 ? 'a slug' : 'slugs'} that cannot be a file path (${unsafe.map((article) => JSON.stringify(article.slug)).join(', ')}).`, 'Nothing was written. A knowledge slug is lowercase letters, digits, ".", "_", "-" and "/" folders, with no "." or ".." folder.');
+    }
+    return articles.map((article) => {
+        var _a;
+        const frontmatter = [
+            '---',
+            `title: ${JSON.stringify(article.title)}`,
+            ...(article.tags.length > 0
+                ? [
+                    `tags: [${article.tags.map((tag) => JSON.stringify(tag)).join(', ')}]`,
+                ]
+                : []),
+            '---',
+            '',
+        ].join('\n');
+        return {
+            path: `${article.slug}.md`,
+            contents: frontmatter + ((_a = article.body) !== null && _a !== void 0 ? _a : ''),
+        };
+    });
+}
+const FRONTMATTER = /^?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
+/** Top-level `title`, `slug` and `tags` only. */
+function splitFrontmatter(markdown) {
+    const match = markdown.match(FRONTMATTER);
+    if (!match)
+        return { fields: {}, tags: [], body: markdown };
+    const fields = {};
+    const tags = [];
+    const lines = match[1].split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        const pair = lines[index].match(/^([A-Za-z0-9_-]+):[ \t]*(.*)$/);
+        if (!pair)
+            continue;
+        const key = pair[1].toLowerCase();
+        const value = pair[2].trim();
+        if (key === 'tags') {
+            if (value) {
+                tags.push(...value.replace(/^\[|\]$/g, '').split(','));
+            }
+            while (index + 1 < lines.length &&
+                /^[ \t]*-[ \t]+/.test(lines[index + 1])) {
+                tags.push(lines[index + 1].replace(/^[ \t]*-[ \t]+/, ''));
+                index += 1;
+            }
+            continue;
+        }
+        fields[key] = unquote(value);
+    }
+    return {
+        fields,
+        tags: [...new Set(tags.map((tag) => unquote(tag.trim())).filter(Boolean))],
+        body: markdown.slice(match[0].length),
+    };
+}
+function unquote(value) {
+    if (value.length >= 2 && value.startsWith('"') && value.endsWith('"')) {
+        try {
+            const parsed = JSON.parse(value);
+            if (typeof parsed === 'string')
+                return parsed;
+        }
+        catch (_a) {
+            // Not JSON-escaped: strip the quotes below.
+        }
+    }
+    if (value.length >= 2 &&
+        ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'")))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+function parseSubcommand(value) {
+    const match = KNOWLEDGE_SUBCOMMANDS.find((name) => name === value);
+    if (match)
+        return match;
+    throw usageError(value
+        ? `Unknown knowledge subcommand "${value}".`
+        : 'knowledge needs a subcommand.', USAGE);
+}
+function requireTarget(value, verb) {
+    if (value === null || value === void 0 ? void 0 : value.trim())
+        return value;
+    throw usageError(verb === 'push'
+        ? 'knowledge push needs a folder of .md files.'
+        : 'knowledge search needs a query.', verb === 'push'
+        ? 'e.g. "ekanos knowledge push ./knowledge --team first-bank".'
+        : 'e.g. "ekanos knowledge search \\"wire cutoff\\" --team first-bank".');
+}
+//# 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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","sourcesContent":["import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { z } from 'zod';\n\nimport type { StoredSession } from '../auth/credential-store';\nimport { loginHint } from '../auth/host-trust';\nimport {\n  type AuthEnvironment,\n  refreshStoredSession,\n  requireSession,\n  resolveAuthEnvironment,\n} from '../auth/session';\nimport type { CliContext } from '../context';\nimport {\n  authRequiredError,\n  invalidStateError,\n  notFoundError,\n  usageError,\n  validationError,\n} from '../errors';\nimport type { ExitCode } from '../exit-codes';\nimport {\n  KNOWLEDGE_PUSH_BATCH,\n  type KnowledgeApiResult,\n  type KnowledgeArticle,\n  KnowledgeListSchema,\n  type KnowledgePruneArticle,\n  KnowledgePruneSchema,\n  type KnowledgePushArticle,\n  type KnowledgePushResult,\n  KnowledgePushSchema,\n  KnowledgeSearchSchema,\n  isSafeKnowledgeSlug,\n  knowledgeCall,\n} from '../knowledge-api';\nimport { type PulledFile, writePulledFiles } from '../pull-write';\nimport { classifyPath } from '../safe-fs';\nimport { resolveSourceTarget } from '../source-target';\nimport { type ResultRow, pluralize } from '../ui';\nimport { promptYesNo } from './publish';\n\nexport const KNOWLEDGE_SUBCOMMANDS = [\n  'list',\n  'push',\n  'search',\n  'pull',\n] as const;\ntype KnowledgeSubcommand = (typeof KNOWLEDGE_SUBCOMMANDS)[number];\n\nexport interface KnowledgeArgs {\n  host?: string;\n  source?: string;\n  subcommand?: string;\n  /** `push <dir>`, `search <query>`. */\n  target?: string;\n  /** A team's slug: that team's collection instead of the Source's General one. */\n  team?: string;\n  /** `pull`: where to write (default `knowledge/<team|general>`). */\n  out?: string;\n  /** `pull`: overwrite local files that differ from the host's. */\n  force?: boolean;\n  /**\n   * `push --prune`: also delete the articles an earlier push of this folder\n   * made whose files are gone. Never an article written in the app, and\n   * never one edited there since the push.\n   */\n  prune?: boolean;\n  /** `push --prune`: delete without asking (a script or agent run). */\n  yes?: boolean;\n  dir: string;\n  env: Record<string, string | undefined>;\n  stdinIsTTY?: boolean;\n  confirm?: (question: string) => Promise<boolean>;\n}\n\nconst USAGE =\n  'Run one of: ekanos knowledge list [--team <slug>] | push <dir> [--team <slug>] [--prune [--yes]] | search <query> --team <slug> | pull [--team <slug>] [--out <dir>] [--force].';\n\n/**\n * `knowledge` — a Source's Knowledge base (plan 244): the General collection\n * every team reads, and with `--team` one team's own collection. `push`\n * turns a folder of markdown files into articles — one per `.md`, keyed by\n * its path, so pushing the same folder again only changes what changed —\n * and `pull` writes them back the same way. `search` runs as a team's\n * agents do: that team's articles plus General.\n */\nexport async function runKnowledge(\n  ctx: CliContext,\n  args: KnowledgeArgs,\n): Promise<ExitCode> {\n  const subcommand = parseSubcommand(args.subcommand);\n  const team = args.team?.trim() || undefined;\n\n  // Read the folder before any network call, so a bad one fails fast.\n  const files =\n    subcommand === 'push'\n      ? readKnowledgeFolder(requireTarget(args.target, 'push'), args.dir)\n      : null;\n  if (args.prune && subcommand !== 'push') {\n    throw usageError(\n      '--prune goes with knowledge push.',\n      'Run \"ekanos knowledge push <dir> --prune\".',\n    );\n  }\n  const origin =\n    subcommand === 'push' ? knowledgeOrigin(args.target!, args.dir) : null;\n  if (\n    args.prune &&\n    classifyPath(path.resolve(args.dir, args.target!)) !== 'directory'\n  ) {\n    throw usageError(\n      '--prune needs a folder: it removes the articles whose files are gone from it.',\n      'Pass the folder you push, e.g. \"ekanos knowledge push ./knowledge --prune\".',\n    );\n  }\n  if (subcommand === 'search') {\n    requireTarget(args.target, 'search');\n    if (!team) {\n      throw usageError(\n        'knowledge search needs --team <slug>.',\n        'Search runs as that team’s agents see it: its articles plus the General collection.',\n      );\n    }\n  }\n\n  const env = resolveAuthEnvironment(ctx, args.host, args.env, {\n    projectDir: args.dir,\n  });\n  const resolved = await resolveSourceTarget(env, requireSession(env), args);\n  const client = new KnowledgeClient(env, resolved.session);\n  const source = resolved.source;\n  const send = <T>(\n    schema: z.ZodType<T>,\n    init: Parameters<typeof knowledgeCall>[3],\n  ) => client.call((token) => knowledgeCall(env.host, token, schema, init));\n  const where = (slug: string) => (team ? `team ${team}` : `${slug} General`);\n\n  switch (subcommand) {\n    case 'list': {\n      const list = await send(KnowledgeListSchema, {\n        method: 'GET',\n        query: { source, team },\n      });\n      if (list.articles.length === 0) {\n        return ctx.succeed(\n          { host: env.host, ...list },\n          ctx.ui.result({\n            title: `No Knowledge articles in ${where(list.source.slug)} yet`,\n            tone: 'warn',\n            notes: [\n              `\"ekanos knowledge push <dir>${team ? ` --team ${team}` : ''}\" stores a folder of .md files.`,\n            ],\n          }),\n        );\n      }\n      return ctx.succeed(\n        { host: env.host, ...list },\n        [\n          ctx.ui.bold(\n            `${pluralize(list.articles.length, 'article')} in ${where(list.source.slug)}`,\n          ),\n          ctx.ui.table(\n            ['Slug', 'Title', 'Tags', 'Version', 'Updated'],\n            list.articles.map((article) => [\n              article.slug,\n              article.title,\n              article.tags.join(', '),\n              `v${article.version}`,\n              article.updatedAt.slice(0, 10),\n            ]),\n          ),\n        ].join('\\n'),\n      );\n    }\n\n    case 'search': {\n      const query = args.target!;\n      const found = await send(KnowledgeSearchSchema, {\n        method: 'GET',\n        path: '/search',\n        query: { source, team, q: query },\n      });\n      if (found.results.length === 0) {\n        return ctx.succeed(\n          { host: env.host, ...found },\n          ctx.ui.result({\n            title: `Nothing in team ${team}'s Knowledge matches \"${query}\"`,\n            tone: 'warn',\n            notes: ['Try fewer or different words.'],\n          }),\n        );\n      }\n      return ctx.succeed(\n        { host: env.host, ...found },\n        ctx.ui.result({\n          title: `${found.results.length === 1 ? '1 match' : `${found.results.length} matches`} for \"${query}\" in team ${team}`,\n          rows: found.results.map((hit) => [\n            `${hit.title} (${hit.collection === 'general' ? 'General' : 'team'})`,\n            [hit.snippet.replace(/\\s+/g, ' '), ctx.ui.dim(hit.slug)],\n          ]),\n        }),\n      );\n    }\n\n    case 'push': {\n      const articles = files!;\n      const keep = articles.map((article) => article.slug);\n      const prune = (deleteSlugs?: string[]) =>\n        send(KnowledgePruneSchema, {\n          method: 'POST',\n          path: '/prune',\n          query: {},\n          body: {\n            source,\n            ...(team ? { team } : {}),\n            origin: origin!,\n            keep,\n            ...(deleteSlugs ? { delete: deleteSlugs } : {}),\n          },\n        });\n      // Ask (or refuse) before anything is written: what would go is known\n      // from the folder alone.\n      const preview = args.prune ? await prune() : null;\n      if (preview && preview.candidates.length > 0) {\n        await confirmPrune(ctx, args, {\n          candidates: preview.candidates,\n          where: where(preview.source.slug),\n          command: `ekanos knowledge push ${args.target}${team ? ` --team ${team}` : ''} --source ${source} --prune --yes`,\n        });\n      }\n\n      const results: KnowledgePushResult[] = [];\n      let pushed: { source: { slug: string } } | null = null;\n      for (\n        let start = 0;\n        start < articles.length;\n        start += KNOWLEDGE_PUSH_BATCH\n      ) {\n        const batch = articles.slice(start, start + KNOWLEDGE_PUSH_BATCH);\n        const response = await send(KnowledgePushSchema, {\n          method: 'POST',\n          query: {},\n          body: {\n            source,\n            ...(team ? { team } : {}),\n            origin: origin!,\n            articles: batch.map(({ file: _file, ...article }) => article),\n          },\n        });\n        pushed = response;\n        results.push(...response.results);\n      }\n      const pruned =\n        preview && preview.candidates.length > 0\n          ? await prune(preview.candidates.map((article) => article.slug))\n          : preview;\n      const count = (status: KnowledgePushResult['status']) =>\n        results.filter((result) => result.status === status).length;\n      const refused = results.filter((result) => result.status === 'refused');\n      const pruneRows: ResultRow[] = pruned\n        ? [\n            [\n              'Pruned',\n              pruned.deleted.length > 0\n                ? pruned.deleted.map((article) => article.slug)\n                : '0',\n            ],\n            ...(pruned.edited.length > 0\n              ? ([\n                  [\n                    'Kept',\n                    pruned.edited.map(\n                      (article) =>\n                        `${article.slug}: its file is gone, but it was edited in the app since it was pushed`,\n                    ),\n                  ],\n                ] as const)\n              : []),\n          ]\n        : [];\n      return ctx.succeed(\n        {\n          host: env.host,\n          team: team ?? null,\n          origin,\n          results,\n          ...(pruned\n            ? { pruned: pruned.deleted, keptEdited: pruned.edited }\n            : {}),\n        },\n        ctx.ui.result({\n          title: `Pushed ${pluralize(results.length, 'article')} to ${where(pushed?.source.slug ?? source)}`,\n          tone: refused.length > 0 ? 'warn' : 'ok',\n          rows: [\n            ['Created', String(count('created'))],\n            ['Updated', String(count('updated'))],\n            ['Unchanged', String(count('unchanged'))],\n            ...(refused.length > 0\n              ? ([\n                  [\n                    'Refused',\n                    refused.map(\n                      (result) => `${result.slug}: ${result.message ?? ''}`,\n                    ),\n                  ],\n                ] as const)\n              : []),\n            ...pruneRows,\n          ],\n          notes: [\n            team\n              ? `Team ${team}'s agents with search_knowledge find these now.`\n              : \"Every team's agents granted search_knowledge find these now, beside their team's own articles.\",\n          ],\n        }),\n      );\n    }\n\n    case 'pull': {\n      const list = await send(KnowledgeListSchema, {\n        method: 'GET',\n        query: { source, team, body: '1' },\n      });\n      const outDir = path.resolve(\n        args.dir,\n        args.out ?? path.join('knowledge', team ?? 'general'),\n      );\n      const written = writePulledFiles({\n        projectDir: args.dir,\n        outDir,\n        files: knowledgeFiles(list.articles),\n        force: args.force === true,\n        rerun: `ekanos knowledge pull${team ? ` --team ${team}` : ''}`,\n      });\n      return ctx.succeed(\n        { host: env.host, team: team ?? null, dir: outDir, files: written },\n        ctx.ui.result({\n          title: `Pulled ${pluralize(written.length, 'article')} from ${where(list.source.slug)}`,\n          rows: [['Into', outDir]],\n          notes: [\n            `Edit, then \"ekanos knowledge push ${path.relative(args.dir, outDir) || '.'}${team ? ` --team ${team}` : ''}\".`,\n          ],\n        }),\n      );\n    }\n  }\n}\n\n/**\n * Which folder a push came from, as the host records it on each article\n * (`synced_from`): the path as named from the project directory, so pushing\n * the same folder from the same place is the same origin. `--prune` only\n * ever removes articles of that origin.\n */\nexport function knowledgeOrigin(target: string, cwd: string): string {\n  const relative = path\n    .relative(cwd, path.resolve(cwd, target))\n    .split(path.sep)\n    .join('/');\n  return (relative || '.').slice(-300);\n}\n\n/**\n * Pruning deletes articles. A person is asked, listing them; a script or\n * agent run needs `--yes`, and is refused before anything is written.\n */\nasync function confirmPrune(\n  ctx: CliContext,\n  args: KnowledgeArgs,\n  target: {\n    candidates: KnowledgePruneArticle[];\n    where: string;\n    command: string;\n  },\n) {\n  if (args.yes) return;\n  const list = target.candidates.map((article) => article.slug);\n  const what = `--prune would delete ${pluralize(list.length, 'article')} from ${target.where} whose files are gone: ${list.join(', ')}`;\n  const canPrompt =\n    !ctx.jsonMode && (args.stdinIsTTY ?? process.stdin.isTTY === true);\n  if (!canPrompt) {\n    throw invalidStateError(\n      `${what}. Nothing was pushed or deleted.`,\n      `Re-run with --yes: ${target.command}`,\n    );\n  }\n  const sure = await (args.confirm ?? promptYesNo)(\n    `${what}. Delete them? [y/N]`,\n  );\n  if (!sure) {\n    throw validationError(\n      'Nothing was pushed or deleted.',\n      'Run it again without --prune to push only.',\n    );\n  }\n}\n\n/** Every call refreshes the session once on a 401, then gives up. */\nclass KnowledgeClient {\n  constructor(\n    private readonly env: AuthEnvironment,\n    private session: StoredSession,\n  ) {}\n\n  async call<T>(\n    send: (accessToken: string) => Promise<KnowledgeApiResult<T>>,\n  ): Promise<T> {\n    let result = await send(this.session.accessToken);\n    if (result.status === 'unauthorized') {\n      this.session = await refreshStoredSession(this.env, this.session);\n      result = await send(this.session.accessToken);\n    }\n    if (result.status === 'ok') return result.data;\n    throw authRequiredError(\n      `The session for ${this.env.host} could not authorize the knowledge call.`,\n      loginHint(this.env),\n    );\n  }\n}\n\n/** Mirrors the host's `knowledgeSlug`: a file's path without `.md`. */\nexport function knowledgeSlugFromPath(relative: string): string {\n  return relative\n    .trim()\n    .toLowerCase()\n    .replace(/\\\\/g, '/')\n    .replace(/\\.(md|markdown|mdx)$/, '')\n    .normalize('NFKD')\n    .replace(/[̀-ͯ]/g, '')\n    .replace(/[^a-z0-9._/-]+/g, '-')\n    .replace(/\\/+/g, '/')\n    .replace(/-{2,}/g, '-')\n    .split('/')\n    .map((part) => part.replace(/^[-.]+|[-.]+$/g, ''))\n    .filter(Boolean)\n    .join('/')\n    .slice(0, 200);\n}\n\nconst IGNORED = new Set(['node_modules', '.git']);\nconst MARKDOWN = /\\.(md|markdown|mdx)$/i;\nconst BODY_MAX = 200_000;\n\n/**\n * Every markdown file under `target`, as articles. The title is the\n * frontmatter `title:`, else the first `# heading` (taken out of the body so\n * it is not shown twice), else the file name; tags are the frontmatter\n * `tags:` (`[a, b]`, `a, b` or a `- a` list).\n */\nexport function readKnowledgeFolder(\n  target: string,\n  cwd: string,\n): (KnowledgePushArticle & { file: string })[] {\n  const root = path.resolve(cwd, target);\n  const kind = classifyPath(root);\n  if (kind !== 'directory' && kind !== 'file') {\n    throw notFoundError(\n      `No folder or file at ${root}.`,\n      'Pass a folder of .md files, e.g. \"ekanos knowledge push ./knowledge\".',\n    );\n  }\n\n  const found: string[] = [];\n  const walk = (dir: string) => {\n    for (const name of fs.readdirSync(dir).sort()) {\n      if (IGNORED.has(name) || name.startsWith('.')) continue;\n      const full = path.join(dir, name);\n      const entry = classifyPath(full);\n      if (entry === 'directory') walk(full);\n      else if (entry === 'file' && MARKDOWN.test(name)) found.push(full);\n    }\n  };\n  if (kind === 'file') {\n    const name = path.basename(root);\n    if (name.startsWith('.') || !MARKDOWN.test(name)) {\n      throw validationError(\n        `${root} is not a markdown file, so it was not pushed.`,\n        'Pass a .md, .markdown or .mdx file (not a dotfile), or a folder of them.',\n      );\n    }\n    found.push(root);\n  } else walk(root);\n\n  if (found.length === 0) {\n    throw validationError(\n      `No .md files under ${root}.`,\n      'Each markdown file becomes one article.',\n    );\n  }\n\n  const base = kind === 'file' ? path.dirname(root) : root;\n  const seen = new Map<string, string>();\n  return found.map((file) => {\n    const relative = path.relative(base, file).split(path.sep).join('/');\n    const markdown = fs.readFileSync(file, 'utf8');\n    const { fields, tags, body } = splitFrontmatter(markdown);\n    const slug = knowledgeSlugFromPath(fields.slug || relative);\n    if (!slug) {\n      throw validationError(\n        `${file}: no usable slug.`,\n        'Rename the file with letters or digits.',\n      );\n    }\n    const clash = seen.get(slug);\n    if (clash) {\n      throw validationError(\n        `${file} and ${clash} both become \"${slug}\".`,\n        'Rename one of them.',\n      );\n    }\n    seen.set(slug, file);\n\n    const heading = fields.title\n      ? null\n      : body.match(/^[ \\t]*#[ \\t]+(.+?)[ \\t]*#*[ \\t]*$/m);\n    const title = (\n      fields.title ||\n      heading?.[1] ||\n      path.basename(file).replace(MARKDOWN, '').replace(/[-_]+/g, ' ')\n    )\n      .trim()\n      .slice(0, 300);\n    const text = (heading ? body.replace(heading[0], '') : body).replace(\n      /^\\s*\\n/,\n      '',\n    );\n    if (text.length > BODY_MAX) {\n      throw validationError(\n        `${file} is longer than ${BODY_MAX.toLocaleString()} characters.`,\n        'Split it into smaller articles.',\n      );\n    }\n    return {\n      file,\n      slug,\n      title: title || slug,\n      body: text,\n      ...(tags.length > 0 ? { tags: tags.slice(0, 30) } : {}),\n    };\n  });\n}\n\n/** One `.md` per article: its title and tags as frontmatter, then the body. */\nfunction knowledgeFiles(articles: KnowledgeArticle[]): PulledFile[] {\n  const unsafe = articles.filter(\n    (article) => !isSafeKnowledgeSlug(article.slug),\n  );\n  if (unsafe.length > 0) {\n    throw validationError(\n      `Refusing to pull: the host sent ${unsafe.length === 1 ? 'a slug' : 'slugs'} that cannot be a file path (${unsafe.map((article) => JSON.stringify(article.slug)).join(', ')}).`,\n      'Nothing was written. A knowledge slug is lowercase letters, digits, \".\", \"_\", \"-\" and \"/\" folders, with no \".\" or \"..\" folder.',\n    );\n  }\n  return articles.map((article) => {\n    const frontmatter = [\n      '---',\n      `title: ${JSON.stringify(article.title)}`,\n      ...(article.tags.length > 0\n        ? [\n            `tags: [${article.tags.map((tag) => JSON.stringify(tag)).join(', ')}]`,\n          ]\n        : []),\n      '---',\n      '',\n    ].join('\\n');\n    return {\n      path: `${article.slug}.md`,\n      contents: frontmatter + (article.body ?? ''),\n    };\n  });\n}\n\nconst FRONTMATTER = /^?---[ \\t]*\\r?\\n([\\s\\S]*?)\\r?\\n---[ \\t]*(?:\\r?\\n|$)/;\n\n/** Top-level `title`, `slug` and `tags` only. */\nfunction splitFrontmatter(markdown: string): {\n  fields: Record<string, string>;\n  tags: string[];\n  body: string;\n} {\n  const match = markdown.match(FRONTMATTER);\n  if (!match) return { fields: {}, tags: [], body: markdown };\n  const fields: Record<string, string> = {};\n  const tags: string[] = [];\n  const lines = match[1]!.split(/\\r?\\n/);\n  for (let index = 0; index < lines.length; index += 1) {\n    const pair = lines[index]!.match(/^([A-Za-z0-9_-]+):[ \\t]*(.*)$/);\n    if (!pair) continue;\n    const key = pair[1]!.toLowerCase();\n    const value = pair[2]!.trim();\n    if (key === 'tags') {\n      if (value) {\n        tags.push(...value.replace(/^\\[|\\]$/g, '').split(','));\n      }\n      while (\n        index + 1 < lines.length &&\n        /^[ \\t]*-[ \\t]+/.test(lines[index + 1]!)\n      ) {\n        tags.push(lines[index + 1]!.replace(/^[ \\t]*-[ \\t]+/, ''));\n        index += 1;\n      }\n      continue;\n    }\n    fields[key] = unquote(value);\n  }\n  return {\n    fields,\n    tags: [...new Set(tags.map((tag) => unquote(tag.trim())).filter(Boolean))],\n    body: markdown.slice(match[0].length),\n  };\n}\n\nfunction unquote(value: string): string {\n  if (value.length >= 2 && value.startsWith('\"') && value.endsWith('\"')) {\n    try {\n      const parsed: unknown = JSON.parse(value);\n      if (typeof parsed === 'string') return parsed;\n    } catch {\n      // Not JSON-escaped: strip the quotes below.\n    }\n  }\n  if (\n    value.length >= 2 &&\n    ((value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\")))\n  ) {\n    return value.slice(1, -1);\n  }\n  return value;\n}\n\nfunction parseSubcommand(value: string | undefined): KnowledgeSubcommand {\n  const match = KNOWLEDGE_SUBCOMMANDS.find((name) => name === value);\n  if (match) return match;\n  throw usageError(\n    value\n      ? `Unknown knowledge subcommand \"${value}\".`\n      : 'knowledge needs a subcommand.',\n    USAGE,\n  );\n}\n\nfunction requireTarget(value: string | undefined, verb: 'push' | 'search') {\n  if (value?.trim()) return value;\n  throw usageError(\n    verb === 'push'\n      ? 'knowledge push needs a folder of .md files.'\n      : 'knowledge search needs a query.',\n    verb === 'push'\n      ? 'e.g. \"ekanos knowledge push ./knowledge --team first-bank\".'\n      : 'e.g. \"ekanos knowledge search \\\\\"wire cutoff\\\\\" --team first-bank\".',\n  );\n}\n"]}

package/dist/commands/login.d.ts

@@ -17,6 +17,10 @@ export interface LoginArgs {
     claude?: boolean;
     /** Test seam for the Claude Code offer's question. */
     confirm?: (question: string) => Promise<boolean>;
+    /** `--trust-host`: sign in to a host you have never used without the question. */
+    trustHost?: boolean;
+    /** Test seam for the new-host question. */
+    confirmHost?: (question: string) => Promise<boolean>;
 }
 /**
  * `login` — authenticate this machine against an Ekanos deployment via the