@skillcdn/console 0.1.1 → 0.1.3

package/dist/cli/directory.d.ts

@@ -0,0 +1,14 @@
+/** The file's name, in the working directory or one above it. */
+export declare const DIRECTORY_FILE = ".skillcdn-console.json";
+export interface DirectorySettings {
+    /** The key of the project the directory's work belongs to. */
+    readonly project: string;
+}
+export interface DirectoryStore {
+    /** The settings of the working directory, or of the nearest directory above it that has them. */
+    load(): Promise<DirectorySettings | undefined>;
+    /** Writes the settings into the working directory and answers where. */
+    save(settings: DirectorySettings): Promise<string>;
+}
+export declare function createDirectoryStore(cwd: string): DirectoryStore;
+//# sourceMappingURL=directory.d.ts.map

package/dist/cli/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/cli/directory.ts"],"names":[],"mappings":"AASA,iEAAiE;AACjE,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,iGAAiG;IACjG,IAAI,IAAI,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IAC/C,wEAAwE;IACxE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAID,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAgChE"}

package/dist/cli/directory.js

@@ -0,0 +1,46 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import * as z from "zod/mini";
+// What a working directory says about the project it belongs to: `.skillcdn-console.json` in
+// it or in a directory above it, as `.nvmrc` and its kind are found. Written by `console use`,
+// and meant to be committed, so that everyone who works in the checkout, and every agent they
+// run in it, is in the same project without saying so.
+/** The file's name, in the working directory or one above it. */
+export const DIRECTORY_FILE = ".skillcdn-console.json";
+const settingsSchema = z.object({ project: z.string().check(z.minLength(1)) });
+export function createDirectoryStore(cwd) {
+    return {
+        async load() {
+            let directory = cwd;
+            for (;;) {
+                let content;
+                try {
+                    content = await readFile(join(directory, DIRECTORY_FILE), "utf8");
+                }
+                catch {
+                    content = undefined;
+                }
+                if (content !== undefined) {
+                    try {
+                        const parsed = settingsSchema.safeParse(JSON.parse(content));
+                        return parsed.success ? parsed.data : undefined;
+                    }
+                    catch {
+                        return undefined;
+                    }
+                }
+                const above = dirname(directory);
+                if (above === directory) {
+                    return undefined;
+                }
+                directory = above;
+            }
+        },
+        async save(settings) {
+            const path = join(cwd, DIRECTORY_FILE);
+            await writeFile(path, `${JSON.stringify(settings, null, 2)}\n`);
+            return path;
+        },
+    };
+}
+//# sourceMappingURL=directory.js.map

package/dist/cli/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/cli/directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B,6FAA6F;AAC7F,+FAA+F;AAC/F,8FAA8F;AAC9F,uDAAuD;AAEvD,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAcvD,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE/E,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO;QACL,KAAK,CAAC,IAAI;YACR,IAAI,SAAS,GAAG,GAAG,CAAC;YACpB,SAAS,CAAC;gBACR,IAAI,OAA2B,CAAC;gBAChC,IAAI,CAAC;oBACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;gBACpE,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,GAAG,SAAS,CAAC;gBACtB,CAAC;gBACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;wBAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;oBAClD,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,SAAS,CAAC;oBACnB,CAAC;gBACH,CAAC;gBACD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;gBACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ;YACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YACvC,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/format.d.ts

@@ -1,11 +1,14 @@
-import type { RestArtifact, RestDecision, RestRun, RestSkills, RestTask } from "../schemas.js";
+import type { RestArtifact, RestDecision, RestDocument, RestDocumentSummary, RestDocuments, RestProject, RestRun, RestSkills, RestTask, RestVersion, RestVersionSummary } from "../schemas.js";
+/** One project: its key, its name, what the person is in it, and what waits in it. */
+export declare function formatProjectLine(project: RestProject): string;
 export declare function formatTaskLine(task: RestTask): string;
 /** One task in full; with the decisions about it and the runs on it, when given. */
 export declare function formatTask(task: RestTask, decisions?: readonly RestDecision[], runs?: readonly RestRun[]): string;
 export declare function formatRunLine(run: RestRun): string;
-export declare function formatRun(run: RestRun): string;
+/** One run in full; with where each file handed in is read, when the caller knows. */
+export declare function formatRun(run: RestRun, fileUrl?: (artifactId: string) => string): string;
 /** What was handed in: the link, or the file with its size and where its bytes are read. */
-export declare function formatArtifact(artifact: RestArtifact): string;
+export declare function formatArtifact(artifact: RestArtifact, fileUrl?: (artifactId: string) => string): string;
 /** The organization's skills: where they are, and each with what an agent loads it by. */
 export declare function formatSkills(skills: RestSkills): string;
 export declare function formatDecisionLine(decision: RestDecision): string;
@@ -13,4 +16,13 @@ export declare function formatOptions(decision: RestDecision): string;
 /** The answer, with who gave it; or that there is none yet. */
 export declare function formatAnswer(decision: RestDecision): string;
 export declare function formatDecision(decision: RestDecision): string;
+/** One document in a list: its path, its title, its version, who wrote it last and when. */
+export declare function formatDocumentLine(document: RestDocumentSummary): string;
+/** A folder's folders and pages, or the pages a search found. */
+export declare function formatDocuments(listing: RestDocuments): string;
+/** One document in full: its latest version, what it links to, what refers to it, and its files. */
+export declare function formatDocument(document: RestDocument, fileUrl?: (fileId: string) => string): string;
+export declare function formatVersionLine(version: RestVersionSummary): string;
+/** One version of a document, with its body as it was. */
+export declare function formatVersion(path: string, version: RestVersion): string;
 //# sourceMappingURL=format.d.ts.map

package/dist/cli/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAoB/F,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAYrD;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,SAAS,YAAY,EAAE,EACnC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,GACxB,MAAM,CA4BR;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAqB9C;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAM7D;AASD,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAoBvD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAGjE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAE5D;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAa3D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAU7D"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,OAAO,EACP,UAAU,EACV,QAAQ,EACR,WAAW,EACX,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAoBvB,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAS9D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAYrD;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,SAAS,YAAY,EAAE,EACnC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,GACxB,MAAM,CA4BR;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAqBxF;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GACvC,MAAM,CAMR;AASD,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAoBvD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAGjE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAE5D;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAa3D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAa7D;AAMD,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAMxE;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAS9D;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GACnC,MAAM,CAkCR;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAErE;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAMxE"}

package/dist/cli/format.js

@@ -1,4 +1,3 @@
-import { restPath } from "../routes.js";
 // What the command prints: one line per thing in a list, a few lines for one thing in full.
 // Plain text, for an agent to read and a person to skim; ids are given, since the commands take
 // them, and the words are the vocabulary's own, since the options take those.
@@ -11,6 +10,17 @@ const indent = (text) => text
 const asker = (decision) => decision.run === null
     ? decision.raisedBy.login
     : `${decision.run.agent} for ${decision.raisedBy.login}`;
+/** One project: its key, its name, what the person is in it, and what waits in it. */
+export function formatProjectLine(project) {
+    const notes = [project.role];
+    if (project.openDecisions > 0) {
+        notes.push(`${plural(project.openDecisions, "decision")} waiting`);
+    }
+    if (project.openRuns > 0) {
+        notes.push(`${plural(project.openRuns, "agent")} at work`);
+    }
+    return `${project.key}  ${project.name}  (${notes.join("; ")})`;
+}
 export function formatTaskLine(task) {
     const notes = [`owner ${task.owner.login}`];
     if (task.assignee !== null) {
@@ -61,7 +71,8 @@ export function formatRunLine(run) {
     }
     return `${run.id}  ${run.status}  ${run.agent} for ${run.person.login}  task #${run.taskNumber}  (${notes.join(", ")})`;
 }
-export function formatRun(run) {
+/** One run in full; with where each file handed in is read, when the caller knows. */
+export function formatRun(run, fileUrl) {
     const lines = [
         formatRunLine(run),
         `started: ${run.startedAt}${run.endedAt === null ? "" : `  ended: ${run.endedAt}`}`,
@@ -78,16 +89,16 @@ export function formatRun(run) {
     if (run.artifacts.length > 0) {
         lines.push("", "artifacts:");
         for (const artifact of run.artifacts) {
-            lines.push(`  ${formatArtifact(artifact)}`);
+            lines.push(`  ${formatArtifact(artifact, fileUrl)}`);
         }
     }
     return lines.join("\n");
 }
 /** What was handed in: the link, or the file with its size and where its bytes are read. */
-export function formatArtifact(artifact) {
+export function formatArtifact(artifact, fileUrl) {
     const what = artifact.file === null
         ? (artifact.url ?? "")
-        : `${artifact.file.name} (${artifact.file.size} bytes, ${artifact.file.contentType}; read at ${restPath("files", artifact.id)})`;
+        : `${artifact.file.name} (${artifact.file.size} bytes, ${artifact.file.contentType}${fileUrl === undefined ? "" : `; read at ${fileUrl(artifact.id)}`})`;
     return artifact.label === null ? what : `${artifact.label}: ${what}`;
 }
 const SKILLS_WORDS = {
@@ -99,7 +110,7 @@ const SKILLS_WORDS = {
 /** The organization's skills: where they are, and each with what an agent loads it by. */
 export function formatSkills(skills) {
     if (skills.status === "none" || skills.address === null) {
-        return "No skills address is configured on this console.";
+        return "No skills address: neither this project nor the console names one.";
     }
     const head = `skills at ${skills.address}, served by ${skills.source}: ${skills.status}`;
     if (skills.status !== "ready") {
@@ -146,6 +157,73 @@ export function formatDecision(decision) {
         lines.push("", decision.body.trimEnd());
     }
     lines.push("", "options:", formatOptions(decision), "", formatAnswer(decision));
+    if (decision.outcome !== null && decision.outcome.trim().length > 0) {
+        lines.push("", "what followed:", indent(decision.outcome));
+    }
+    return lines.join("\n");
+}
+/** Who wrote a version, and through which agent. */
+const writer = (by, agent) => agent === null ? by.login : `${agent} for ${by.login}`;
+/** One document in a list: its path, its title, its version, who wrote it last and when. */
+export function formatDocumentLine(document) {
+    const notes = [`v${document.version}`, `by ${writer(document.updatedBy, document.agent)}`];
+    if (document.archivedAt !== null) {
+        notes.push("archived");
+    }
+    return `${document.path}  ${document.title}  (${notes.join(", ")}; ${document.updatedAt})`;
+}
+/** A folder's folders and pages, or the pages a search found. */
+export function formatDocuments(listing) {
+    if (listing.folders.length === 0 && listing.items.length === 0) {
+        return "No pages here.";
+    }
+    const lines = listing.folders.map((folder) => `${folder}/`);
+    for (const document of listing.items) {
+        lines.push(formatDocumentLine(document));
+    }
+    return lines.join("\n");
+}
+/** One document in full: its latest version, what it links to, what refers to it, and its files. */
+export function formatDocument(document, fileUrl) {
+    const lines = [
+        `${document.path}: ${document.title}`,
+        `version ${document.version}, by ${writer(document.updatedBy, document.agent)} at ${document.updatedAt}${document.archivedAt === null ? "" : `; archived ${document.archivedAt}`}`,
+        `id: ${document.id}`,
+    ];
+    if (document.body.trim().length > 0) {
+        lines.push("", document.body.trimEnd());
+    }
+    if (document.links.length > 0) {
+        lines.push("", "refers to:");
+        for (const link of document.links) {
+            lines.push(`  ${link.path}${link.title === null ? "  (no page there yet)" : `  ${link.title}`}`);
+        }
+    }
+    if (document.backlinks.length > 0) {
+        lines.push("", "referred to by:");
+        for (const backlink of document.backlinks) {
+            lines.push(`  ${backlink.kind} ${backlink.kind === "task" ? `#${backlink.number ?? "?"}` : (backlink.path ?? backlink.id)}  ${backlink.title}`);
+        }
+    }
+    if (document.files.length > 0) {
+        lines.push("", "files:");
+        for (const attached of document.files) {
+            const where = fileUrl === undefined ? "" : `; read at ${fileUrl(attached.id)}`;
+            const what = `${attached.file.name} (${attached.file.size} bytes, ${attached.file.contentType}${where})`;
+            lines.push(`  ${attached.label === null ? what : `${attached.label}: ${what}`}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatVersionLine(version) {
+    return `v${version.number}  ${version.title}  (by ${writer(version.author, version.agent)}; ${version.createdAt})`;
+}
+/** One version of a document, with its body as it was. */
+export function formatVersion(path, version) {
+    const lines = [`${path}: ${version.title}`, formatVersionLine(version)];
+    if (version.body.trim().length > 0) {
+        lines.push("", version.body.trimEnd());
+    }
     return lines.join("\n");
 }
 //# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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

package/dist/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAgBD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA2H9D,CAAC;AAkCF,yFAAyF;AACzF,wBAAgB,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAc9C;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAaxD"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAmBD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA8L9D,CAAC;AA0CF,yFAAyF;AACzF,wBAAgB,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAc9C;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAaxD"}

package/dist/cli/help.js

@@ -1,4 +1,4 @@
-import { MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_FILE_BYTES, MAX_LINK_LABEL_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_SUMMARY_LENGTH, MAX_TITLE_LENGTH, MIN_OPTIONS, } from "../limits.js";
+import { MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_DOCUMENT_LENGTH, MAX_DOCUMENT_PATH_LENGTH, MAX_FILE_BYTES, MAX_FILES_PER_DOCUMENT, MAX_LINK_LABEL_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_SUMMARY_LENGTH, MAX_TITLE_LENGTH, MAX_VERSIONS_PER_DOCUMENT, MIN_OPTIONS, } from "../limits.js";
 /** The refusals any command may meet, said once in the overview. */
 const COMMON_REFUSALS = [
     "auth.required: the token is not one the console knows, any more or at all; a person signs the command in again",
@@ -10,6 +10,8 @@ const RUN_REFUSALS = [
     "run.over: the run has ended already",
 ];
 const MARKDOWN = `Markdown, up to ${MAX_BODY_LENGTH} characters`;
+const DOCUMENT_PATH = `a path of lowercase letters, digits and hyphens, with slashes between its folders (guides/onboarding), up to ${MAX_DOCUMENT_PATH_LENGTH} characters; it does not change once written`;
+const DOCUMENT_REFUSALS = ["document.not_found: no page has that path in this project"];
 export const COMMAND_HELP = {
     login: {
         usage: "login --url <origin> [--token-stdin]",
@@ -22,7 +24,16 @@ export const COMMAND_HELP = {
     },
     whoami: {
         usage: "whoami",
-        about: "Who the token acts as, and which console it is for.",
+        about: "Who the token acts as, which console it is for, and which project this directory works in.",
+    },
+    projects: {
+        usage: "projects",
+        about: "The projects you may work in: each with its key, its name, what you are in it, and what waits in it. Every command on the board works in one project.",
+    },
+    use: {
+        usage: "use <key>",
+        about: "Says which project this directory works in: writes .skillcdn-console.json here, which the commands read from this directory or one above it, and which is meant to be committed. --project <key> on any command, or CONSOLE_PROJECT in the environment, wins over it.",
+        refusals: ["project.not_found: no project has the key, or it is not yours to see"],
     },
     tasks: {
         usage: "tasks [--state <state>]",
@@ -83,8 +94,9 @@ export const COMMAND_HELP = {
         refusals: ["decision.invalid_run: the run is not yours, or is over"],
     },
     decision: {
-        usage: "decision <id> [--wait <seconds>]",
-        about: "One decision, with its options and its answer. With --wait, holds on for the answer that long, and exits with 3 if it is still to come.",
+        usage: "decision <id> [--wait <seconds>]  |  decision <id> --outcome <markdown>|--file <path>",
+        about: "One decision, with its context, its options, its answer and what followed. With --wait, holds on for the answer that long, and exits with 3 if it is still to come. With --outcome, writes down what followed the decision, so that it reads as a record.",
+        limits: [`outcome: ${MARKDOWN}`],
         refusals: ["decision.not_found: no decision has that id"],
     },
     decisions: {
@@ -118,16 +130,66 @@ export const COMMAND_HELP = {
         about: "One run in full: its reports, what it handed in, what it waits for, how it ended.",
         refusals: ["run.not_found: no run has that id"],
     },
+    docs: {
+        usage: "docs [<folder>] [--search <words>] [--archived]",
+        about: "The pages of the project's documents: those in a folder, with the folders in it (the root when none is named), or those found by words in their title or body. Archived pages are left out unless --archived.",
+    },
+    doc: {
+        usage: "doc <path> [--version <n>|--versions]",
+        about: "One page in full: its title, its body in Markdown, what it links to, what refers to it (pages, tasks, decisions), and its files. --versions lists its versions, who wrote each and when; --version <n> prints one as it was.",
+        refusals: [...DOCUMENT_REFUSALS, "document.version_not_found: the page has no such version"],
+    },
+    write: {
+        usage: 'write <path> [--title "<title>"] --body <markdown>|--file <path> [--base <version>]',
+        about: "Writes a page: the first version at a new path, or a new version of the page there. A link in the body whose destination is a page's path (guides/onboarding) refers to that page, and the page says what refers to it. Without --title the page keeps its title. With --base, the write is refused if the page has moved on since that version.",
+        limits: [
+            `path: ${DOCUMENT_PATH}`,
+            `title: one line, up to ${MAX_TITLE_LENGTH} characters`,
+            `body: Markdown, up to ${MAX_DOCUMENT_LENGTH} characters`,
+            `at most ${MAX_VERSIONS_PER_DOCUMENT} versions of one page`,
+        ],
+        refusals: [
+            "document.invalid_path: the path is not one",
+            "document.conflict: the page has moved on since --base; read it again",
+            "document.archived: the page is archived; restore it first",
+            "document.too_many_versions: the page carries as many versions as one may; write a new page",
+        ],
+    },
+    attach: {
+        usage: "attach <path> <file> [--label <words>]",
+        about: "Attaches a file from this machine to a page: the console keeps it, and the page shows it.",
+        limits: [
+            `a file: up to ${MAX_FILE_BYTES} bytes, not empty; it is called by its name, without the path`,
+            `at most ${MAX_FILES_PER_DOCUMENT} files on one page`,
+        ],
+        refusals: [
+            ...DOCUMENT_REFUSALS,
+            "document.archived: the page is archived; restore it first",
+            "document.too_many_files: the page carries as many files as one may",
+            "request.too_large: the file is over the limit",
+        ],
+    },
+    archive: {
+        usage: "archive <path>",
+        about: "Puts a page away: out of the folders and the search, still readable at its path, not written to until restored. Nothing is deleted.",
+        refusals: DOCUMENT_REFUSALS,
+    },
+    restore: {
+        usage: "restore <path>",
+        about: "Brings an archived page back.",
+        refusals: DOCUMENT_REFUSALS,
+    },
 };
 /** The first lines of the usage, with the version of the command when it is known. */
 const preamble = (version) => `console${version === undefined ? "" : ` ${version}`}: the board of your organization's work with AI agents, from the command line.
 You act as the person whose token you hold; everything you send is shown to people as text.
 
-Usage: console <command> [arguments] [--json] [--url <origin>]
+Usage: console <command> [arguments] [--json] [--url <origin>] [--project <key>]
 `;
-const CLOSING = `Options everywhere: --json answers with the console's own JSON; --url names another console.
-Commands on a run (report, hand-in, ask, finish, fail) act on your one open run; with several open,
-say which with --run <id>. A Markdown body given as - is read from standard input.
+const CLOSING = `Options everywhere: --json answers with the console's own JSON; --url names another console;
+--project names the project to work in, over CONSOLE_PROJECT and over what console use kept here.
+Commands on a run (report, hand-in, ask, finish, fail) act on your one open run in the project;
+with several open, say which with --run <id>. A Markdown body given as - is read from standard input.
 console help <command> says what each command takes, the limits the console holds it to, and
 what it may refuse. console --version says which version of the command this is.
 
@@ -140,12 +202,19 @@ Credentials: CONSOLE_URL and CONSOLE_TOKEN in the environment, else what login k
 $XDG_CONFIG_HOME/skillcdn-console/credentials.json (~/.config when XDG_CONFIG_HOME is unset).
 `;
 const SECTIONS = [
-    { title: "Signing in, once, as a person", commands: ["login", "logout", "whoami"] },
+    {
+        title: "Signing in, once, as a person, and the project to work in",
+        commands: ["login", "logout", "whoami", "projects", "use"],
+    },
     {
         title: "The board",
         commands: ["tasks", "task", "decisions", "decision", "runs", "run", "skills"],
     },
     { title: "Working", commands: ["take", "report", "hand-in", "ask", "finish", "fail", "abandon"] },
+    {
+        title: "The documents: the project's pages of Markdown, in folders, by path",
+        commands: ["docs", "doc", "write", "attach", "archive", "restore"],
+    },
 ];
 /** The whole usage, as `console help` prints it, naming the version when it is known. */
 export function usage(version) {

package/dist/cli/help.js.map

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

package/dist/cli/main.js

@@ -4,6 +4,7 @@ import process from "node:process";
 import * as z from "zod/mini";
 import { runCli } from "./cli.js";
 import { createFileStore, defaultConfigDir } from "./credentials.js";
+import { createDirectoryStore } from "./directory.js";
 import { readBytesAt, readFileAt, readSecret, readStdin } from "./terminal.js";
 // The `console` command: the only place the command reads the process. Everything it does is in
 // cli.ts, which takes what it needs and is what the tests run.
@@ -25,6 +26,7 @@ process.exitCode = await runCli(process.argv.slice(2), {
     readFile: readFileAt,
     readBytes: readBytesAt,
     store: createFileStore(defaultConfigDir(process.env)),
+    directory: createDirectoryStore(process.cwd()),
     sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
     now: () => Date.now(),
     version: manifest.success ? manifest.data.version : undefined,

package/dist/cli/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/E,gGAAgG;AAChG,+DAA+D;AAE/D,mGAAmG;AACnG,MAAM,QAAQ,GAAG,CAAC;KACf,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;KAC/B,SAAS,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAEnE,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACrD,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;IAC1C,SAAS;IACT,UAAU;IACV,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,eAAe,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrD,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;CAC9D,CAAC,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/E,gGAAgG;AAChG,+DAA+D;AAE/D,mGAAmG;AACnG,MAAM,QAAQ,GAAG,CAAC;KACf,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;KAC/B,SAAS,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAEnE,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACrD,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;IAC1C,SAAS;IACT,UAAU;IACV,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,eAAe,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrD,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9C,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;CAC9D,CAAC,CAAC"}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { type RestAnswerInput, type RestArtifactInput, type RestDecision, type RestDecisionInput, type RestDecisions, type RestEvents, type RestMe, type RestPeople, type RestPerson, type RestPersonPatch, type RestReportInput, type RestRun, type RestRunEndInput, type RestRunInput, type RestRuns, type RestSkills, type RestTask, type RestTaskInput, type RestTaskPatch, type RestTasks, type RestTokenCreated, type RestTokenInput, type RestTokens } from "./schemas.js";
+import { type RestAnswerInput, type RestArtifactInput, type RestDecision, type RestDecisionInput, type RestDecisionPatch, type RestDecisions, type RestDocument, type RestDocumentInput, type RestDocuments, type RestEvents, type RestMe, type RestMember, type RestMemberInput, type RestMemberPatch, type RestMembers, type RestPeople, type RestPerson, type RestPersonPatch, type RestProject, type RestProjectInput, type RestProjectPatch, type RestProjects, type RestReportInput, type RestRun, type RestRunEndInput, type RestRunInput, type RestRuns, type RestSkills, type RestTask, type RestTaskInput, type RestTaskPatch, type RestTasks, type RestTokenCreated, type RestTokenInput, type RestTokens, type RestVersion, type RestVersions } from "./schemas.js";
 import type { TaskState } from "./vocabulary.js";
 export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
 /** A file to hand in: its bytes, what to call it, and what it is. */
@@ -29,11 +29,36 @@ export declare class ApiError extends Error {
     readonly code: string;
     constructor(status: number, code: string, message: string);
 }
-export interface ConsoleClient {
-    me(signal?: AbortSignal): Promise<RestMe>;
-    people(signal?: AbortSignal): Promise<RestPeople>;
-    /** Changes what a person is; for an administrator. */
-    updatePerson(id: string, patch: RestPersonPatch): Promise<RestPerson>;
+/** What the events of a project are filtered by: those about one task, one run, one decision or one document. */
+export interface EventFilter {
+    readonly task?: string | undefined;
+    readonly run?: string | undefined;
+    readonly decision?: string | undefined;
+    readonly document?: string | undefined;
+}
+/** What a folder's listing, or a search, of the documents is narrowed to. */
+export interface DocumentFilter {
+    /** The folder to list, `""` or left out for the root. */
+    readonly folder?: string | undefined;
+    /** Words to find pages by; given, the folder is not looked at. */
+    readonly q?: string | undefined;
+    /** Whether archived pages are listed too. */
+    readonly archived?: boolean | undefined;
+}
+/** The board of one project, as the asker may see and change it. */
+export interface ProjectClient {
+    /** The key the project is reached by. */
+    readonly key: string;
+    /** The project, with what the asker is in it. */
+    get(signal?: AbortSignal): Promise<RestProject>;
+    /** Changes the project's settings; for an owner. */
+    update(patch: RestProjectPatch): Promise<RestProject>;
+    /** Those listed in the project, by login. */
+    members(signal?: AbortSignal): Promise<RestMembers>;
+    /** Lists a person of the workspace in the project; for an owner. */
+    addMember(input: RestMemberInput): Promise<RestMember>;
+    updateMember(personId: string, patch: RestMemberPatch): Promise<RestMember>;
+    removeMember(personId: string): Promise<void>;
     tasks(filter?: {
         readonly state?: TaskState;
     }, signal?: AbortSignal): Promise<RestTasks>;
@@ -54,6 +79,8 @@ export interface ConsoleClient {
     awaitDecision(id: string, waitSeconds: number, signal?: AbortSignal): Promise<RestDecision>;
     raiseDecision(input: RestDecisionInput): Promise<RestDecision>;
     answerDecision(id: string, input: RestAnswerInput): Promise<RestDecision>;
+    /** Grows a decision's record: its context, or what followed. */
+    updateDecision(id: string, patch: RestDecisionPatch): Promise<RestDecision>;
     /** The runs, newest first; or only those on one task, only the open ones, only the asker's own. */
     runs(filter?: {
         readonly task?: string;
@@ -73,12 +100,44 @@ export interface ConsoleClient {
     fileUrl(artifactId: string): string;
     /** Ends a run: finished or failed by the agent; abandoned by the person it is for, or an administrator. */
     endRun(runId: string, input: RestRunEndInput): Promise<RestRun>;
-    /** What happened after event number `after`; `0` for the beginning. */
-    events(after: number, signal?: AbortSignal): Promise<RestEvents>;
-    /** Where an `EventSource` subscribes to what happens after event number `after`. */
+    /** What happened in the project after event number `after`; `0` for the beginning. Narrowed by `filter`. */
+    events(after: number, filter?: EventFilter, signal?: AbortSignal): Promise<RestEvents>;
+    /** Where an `EventSource` subscribes to what happens in the project after event number `after`. */
     eventStreamUrl(after: number): string;
-    /** The organization's skills, as SkillCDN serves them at the console's address. */
+    /** The project's skills, as SkillCDN serves them at its address, or the organization's. */
     skills(signal?: AbortSignal): Promise<RestSkills>;
+    /** A folder's pages and folders, or the pages a search finds. */
+    documents(filter?: DocumentFilter, signal?: AbortSignal): Promise<RestDocuments>;
+    /** One document, by its path: its latest version, its links both ways, its files. */
+    document(path: string, signal?: AbortSignal): Promise<RestDocument>;
+    /** Writes a document at its path, as a new version, or the first one. */
+    writeDocument(path: string, input: RestDocumentInput): Promise<RestDocument>;
+    /** Puts a document away: kept out of the folders and the search, readable, not written to. */
+    archiveDocument(path: string): Promise<RestDocument>;
+    /** Brings an archived document back. */
+    restoreDocument(path: string): Promise<RestDocument>;
+    /** The versions of a document, newest first, each with who wrote it and when. */
+    documentVersions(path: string, signal?: AbortSignal): Promise<RestVersions>;
+    /** One version of a document, with its body as it was. */
+    documentVersion(path: string, number: number, signal?: AbortSignal): Promise<RestVersion>;
+    /** Attaches a file to a document: the console keeps the bytes. */
+    attachFile(path: string, input: FileUpload): Promise<RestDocument>;
+    /** Where the bytes of a file attached to a document are read, by the file's id. */
+    documentFileUrl(path: string, fileId: string): string;
+}
+export interface ConsoleClient {
+    me(signal?: AbortSignal): Promise<RestMe>;
+    people(signal?: AbortSignal): Promise<RestPeople>;
+    /** Changes what a person is; for an administrator. */
+    updatePerson(id: string, patch: RestPersonPatch): Promise<RestPerson>;
+    /** The projects the asker may see, with what they are in each. */
+    projects(signal?: AbortSignal): Promise<RestProjects>;
+    /** Makes a project, whose owner the asker becomes. */
+    createProject(input: RestProjectInput): Promise<RestProject>;
+    /** The board of one project. */
+    project(key: string): ProjectClient;
+    /** The workspace's own events, the ones about no project, after event number `after`. */
+    events(after: number, signal?: AbortSignal): Promise<RestEvents>;
     /** The tokens of whoever asks. */
     tokens(signal?: AbortSignal): Promise<RestTokens>;
     /** Makes a token; the answer carries the secret, this once. */