@skillcdn/console 0.1.17 → 0.1.19

package/dist/cli/credentials.js

@@ -1,11 +1,157 @@
-import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { chmod, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
+import process from "node:process";
 import * as z from "zod/mini";
-const credentialsSchema = z.object({
+export const EMPTY_CREDENTIALS = { default: undefined, logins: [] };
+/** How many consoles one machine may be signed in to: far more than anyone has. */
+export const MAX_LOGINS = 100;
+/** How large the file may be before it is not read: far above a hundred logins. */
+const MAX_FILE_BYTES = 64 * 1024;
+export class CredentialsError extends Error {
+    code;
+    path;
+    constructor(code, path) {
+        super(code === "credentials.too_large"
+            ? `The credentials file ${path} is larger than the command reads.`
+            : `The credentials file ${path} could not be read as one.`);
+        this.name = "CredentialsError";
+        this.code = code;
+        this.path = path;
+    }
+}
+const loginSchema = z.object({
+    url: z.string().check(z.minLength(1), z.maxLength(2048)),
+    account: z.optional(z.string().check(z.minLength(1), z.maxLength(254))),
+    token: z.string().check(z.minLength(1), z.maxLength(1024)),
+    agent: z.optional(z.string().check(z.maxLength(200))),
+    since: z.optional(z.string().check(z.maxLength(40))),
+});
+const fileSchema = z.object({
+    version: z.literal(2),
+    default: z.optional(z.string().check(z.minLength(1), z.maxLength(2048))),
+    logins: z.array(loginSchema).check(z.maxLength(MAX_LOGINS)),
+});
+/** The file as the command kept it before 2026-10: one console, one token. */
+const firstFileSchema = z.object({
     url: z.string().check(z.minLength(1)),
     token: z.string().check(z.minLength(1)),
 });
+/** What a file says, in the current shape; one in the first shape reads as one login, the default. Nothing for anything else. */
+export function parseCredentials(json) {
+    const current = fileSchema.safeParse(json);
+    if (current.success) {
+        return {
+            default: current.data.default,
+            logins: current.data.logins.map((login) => ({
+                url: login.url,
+                account: login.account,
+                token: login.token,
+                agent: login.agent,
+                since: login.since,
+            })),
+        };
+    }
+    const first = firstFileSchema.safeParse(json);
+    if (first.success) {
+        return {
+            default: first.data.url,
+            logins: [
+                {
+                    url: first.data.url,
+                    account: undefined,
+                    token: first.data.token,
+                    agent: undefined,
+                    since: undefined,
+                },
+            ],
+        };
+    }
+    return undefined;
+}
+/** The logins at one console. */
+export function loginsAt(credentials, url) {
+    return credentials.logins.filter((login) => login.url === url);
+}
+/** The consoles signed in to, each once, in the order they were signed in to. */
+export function consolesOf(credentials) {
+    return [...new Set(credentials.logins.map((login) => login.url))];
+}
+/**
+ * With a login kept: in place of the one at the same console for the same account, else added.
+ * The first login kept is the default console, and one kept as the default is.
+ */
+export function withLogin(credentials, login, options = {}) {
+    const rest = credentials.logins.filter((kept) => !(kept.url === login.url && kept.account === login.account));
+    const first = credentials.logins.length === 0 ? login.url : undefined;
+    return {
+        default: options.default === true ? login.url : (credentials.default ?? first),
+        logins: [...rest, login],
+    };
+}
+/**
+ * Without the login at a console, for one account or for every account there. The default
+ * stays while a login at it remains; else it moves to the one console left, or to none.
+ */
+export function withoutLogin(credentials, url, account) {
+    const logins = credentials.logins.filter((kept) => !(kept.url === url && (account === undefined || kept.account === account)));
+    const consoles = [...new Set(logins.map((kept) => kept.url))];
+    const [only] = consoles;
+    const fallback = consoles.length === 1 ? only : undefined;
+    return {
+        default: credentials.default !== undefined && consoles.includes(credentials.default)
+            ? credentials.default
+            : fallback,
+        logins,
+    };
+}
+/**
+ * Which console a command talks to, and with what (ADR-0027). The address comes first: the
+ * flag, else the environment, else the directory, else the default login. The token is then
+ * the one for that address and no other: the environment's token where its address is that
+ * one, else the login kept for it, for the account named or the one account there.
+ */
+export function resolveLogin(lookup) {
+    const { envUrl, envToken } = lookup;
+    if ((envUrl === undefined) !== (envToken === undefined)) {
+        return {
+            ok: false,
+            reason: "environment_half",
+            have: envUrl === undefined ? "CONSOLE_TOKEN" : "CONSOLE_URL",
+        };
+    }
+    const credentials = lookup.credentials ?? EMPTY_CREDENTIALS;
+    const consoles = consolesOf(credentials);
+    const [source, url] = lookup.flagUrl !== undefined
+        ? ["flag", lookup.flagUrl]
+        : envUrl !== undefined
+            ? ["environment", envUrl]
+            : lookup.directoryUrl !== undefined
+                ? ["directory", lookup.directoryUrl]
+                : ["default", credentials.default ?? (consoles.length === 1 ? consoles[0] : undefined)];
+    if (url === undefined) {
+        return { ok: false, reason: "nothing" };
+    }
+    const account = lookup.flagAccount ?? lookup.directoryAccount;
+    if (envUrl !== undefined && envToken !== undefined && envUrl === url) {
+        return { ok: true, url, token: envToken, account, source, via: "environment" };
+    }
+    const at = loginsAt(credentials, url);
+    const chosen = account === undefined ? at : at.filter((login) => login.account === account);
+    const [login] = chosen;
+    if (login === undefined) {
+        return { ok: false, reason: "no_login", url, account, source };
+    }
+    if (chosen.length > 1) {
+        return {
+            ok: false,
+            reason: "ambiguous",
+            url,
+            accounts: chosen.map((kept) => kept.account ?? "?"),
+        };
+    }
+    return { ok: true, url, token: login.token, account: login.account, source, via: "login" };
+}
 const FILE_NAME = "credentials.json";
 /** The directory the file lives in: under `XDG_CONFIG_HOME`, or `~/.config`. */
 export function defaultConfigDir(env) {
@@ -16,24 +162,47 @@ export function createFileStore(directory) {
     const path = join(directory, FILE_NAME);
     return {
         async load() {
-            let content;
+            let size;
             try {
-                content = await readFile(path, "utf8");
+                size = (await stat(path)).size;
             }
             catch {
                 return undefined;
             }
+            if (size > MAX_FILE_BYTES) {
+                throw new CredentialsError("credentials.too_large", path);
+            }
+            let json;
             try {
-                const parsed = credentialsSchema.safeParse(JSON.parse(content));
-                return parsed.success ? parsed.data : undefined;
+                json = JSON.parse(await readFile(path, "utf8"));
             }
             catch {
-                return undefined;
+                throw new CredentialsError("credentials.malformed", path);
+            }
+            const parsed = parseCredentials(json);
+            if (parsed === undefined) {
+                throw new CredentialsError("credentials.malformed", path);
             }
+            return parsed;
         },
         async save(credentials) {
             await mkdir(directory, { recursive: true, mode: 0o700 });
-            await writeFile(path, `${JSON.stringify(credentials, null, 2)}\n`, { mode: 0o600 });
+            const file = {
+                version: 2,
+                default: credentials.default,
+                logins: credentials.logins.map((login) => ({
+                    url: login.url,
+                    account: login.account,
+                    token: login.token,
+                    agent: login.agent,
+                    since: login.since,
+                })),
+            };
+            // Written beside the file and moved over it in one step, so that a command that stops
+            // half-way leaves the file as it was, whole.
+            const draft = `${path}.${process.pid}.tmp`;
+            await writeFile(draft, `${JSON.stringify(file, null, 2)}\n`, { mode: 0o600 });
+            await rename(draft, path);
             // The mode above applies to a file made now; one that was there keeps its own, so it is set again.
             await chmod(path, 0o600).catch(() => undefined);
             return path;

package/dist/cli/credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/cli/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAoB9B,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,GAAiD;IAChF,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,CAAC;IACjC,OAAO,IAAI,CACT,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAC3E,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxC,OAAO;QACL,KAAK,CAAC,IAAI;YACR,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAChE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,WAAW;YACpB,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACzD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACpF,mGAAmG;YACnG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/cli/credentials.ts"],"names":[],"mappings":"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"}

package/dist/cli/directory.d.ts

@@ -3,6 +3,10 @@ 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;
+    /** The origin of the console the directory is bound to; the default login when left out. */
+    readonly url?: string | undefined;
+    /** The account at that console, where several are signed in to it. */
+    readonly account?: string | undefined;
 }
 export interface DirectoryStore {
     /** The settings of the working directory, or of the nearest directory above it that has them. */
@@ -10,5 +14,7 @@ export interface DirectoryStore {
     /** Writes the settings into the working directory and answers where. */
     save(settings: DirectorySettings): Promise<string>;
 }
+/** What a file says, with nothing but the three settings kept; nothing for anything else. */
+export declare function parseDirectorySettings(json: unknown): DirectorySettings | undefined;
 export declare function createDirectoryStore(cwd: string): DirectoryStore;
 //# sourceMappingURL=directory.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/cli/directory.ts"],"names":[],"mappings":"AAcA,iEAAiE;AACjE,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAKvD,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;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;AAQD,6FAA6F;AAC7F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAUnF;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAwChE"}

package/dist/cli/directory.js

@@ -3,11 +3,34 @@ 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.
+// and meant to be committed in a private repository, so that everyone who works in the
+// checkout, and every agent they run in it, is in the same project without saying so; left out
+// of a public one, since it may name the organization's console. It names the project, and
+// where the checkout is bound to a console other than the default login, that console and the
+// account there (ADR-0027). Never a token, a code or anything secret: the token for the console
+// it names is looked up in the credentials the command keeps, and a key this file does not
+// know is dropped on reading.
 /** 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)) });
+/** How large the file may be before it is not read: a few names, never more. */
+const MAX_FILE_CHARS = 16 * 1024;
+const settingsSchema = z.object({
+    project: z.string().check(z.minLength(1), z.maxLength(100)),
+    url: z.optional(z.string().check(z.minLength(1), z.maxLength(2048))),
+    account: z.optional(z.string().check(z.minLength(1), z.maxLength(254))),
+});
+/** What a file says, with nothing but the three settings kept; nothing for anything else. */
+export function parseDirectorySettings(json) {
+    const parsed = settingsSchema.safeParse(json);
+    if (!parsed.success) {
+        return undefined;
+    }
+    return {
+        project: parsed.data.project,
+        ...(parsed.data.url === undefined ? {} : { url: parsed.data.url }),
+        ...(parsed.data.account === undefined ? {} : { account: parsed.data.account }),
+    };
+}
 export function createDirectoryStore(cwd) {
     return {
         async load() {
@@ -21,9 +44,11 @@ export function createDirectoryStore(cwd) {
                     content = undefined;
                 }
                 if (content !== undefined) {
+                    if (content.length > MAX_FILE_CHARS) {
+                        return undefined;
+                    }
                     try {
-                        const parsed = settingsSchema.safeParse(JSON.parse(content));
-                        return parsed.success ? parsed.data : undefined;
+                        return parseDirectorySettings(JSON.parse(content));
                     }
                     catch {
                         return undefined;
@@ -38,7 +63,13 @@ export function createDirectoryStore(cwd) {
         },
         async save(settings) {
             const path = join(cwd, DIRECTORY_FILE);
-            await writeFile(path, `${JSON.stringify(settings, null, 2)}\n`);
+            // The three settings, named one by one: nothing else ever reaches this file.
+            const written = {
+                project: settings.project,
+                ...(settings.url === undefined ? {} : { url: settings.url }),
+                ...(settings.account === undefined ? {} : { account: settings.account }),
+            };
+            await writeFile(path, `${JSON.stringify(written, null, 2)}\n`);
             return path;
         },
     };

package/dist/cli/directory.js.map

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

package/dist/cli/format.d.ts

@@ -1,4 +1,4 @@
-import type { RestArtifact, RestCategory, RestComment, RestDecision, RestDocument, RestDocumentSummary, RestDocuments, RestGoal, RestListing, RestMember, RestPerson, RestPersonWork, RestProject, RestProjectRules, RestRules, RestRun, RestSkills, RestTask, RestVersion, RestVersionSummary, RestWork } from "../schemas.js";
+import type { RestArtifact, RestCategory, RestComment, RestDecision, RestDocument, RestDocumentSummary, RestDocuments, RestGoal, RestListing, RestMember, RestPerson, RestPersonWork, RestProject, RestProjectRules, RestRules, RestRun, RestSkillFile, RestSkillLoad, RestSkillPage, RestSkills, RestTask, RestVersion, RestVersionSummary, RestWork } 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;
 /** One project in full: what it is, how it is marked, and what the person is in it. */
@@ -32,7 +32,7 @@ export declare function formatArtifact(artifact: RestArtifact, fileUrl?: (artifa
 export declare function formatSkills(skills: RestSkills, ownSkills?: string): string;
 /** The rules that hold: the workspace's, and what the project adds when the command works in one. */
 export declare function formatRules(rules: RestProjectRules | RestRules): string;
-/** One goal: its id, its state, its title, when it is due, and how far it is. */
+/** One goal: its id, its state, its title, its category, its days, and how far it is. */
 export declare function formatGoalLine(goal: RestGoal): string;
 /** One goal in full; with the tasks that work towards it, when given. */
 export declare function formatGoal(goal: RestGoal, tasks?: readonly RestTask[]): string;
@@ -56,4 +56,13 @@ export declare function formatDocument(document: RestDocument, fileUrl?: (fileId
 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;
+/**
+ * One skill, as load_skill lays it out for a model (ADR-0028): the rules from the repository's
+ * root to the nearest manifest, the body, the included files, each under a line that names its
+ * path; then the files the skill has and what it refers to. A skill described only is named and
+ * pointed at, and nothing of its body is shown.
+ */
+export declare function formatSkillLoad(loaded: RestSkillLoad, pages: readonly RestSkillPage[]): string;
+/** A file of the pack as read: its text whole, or what the folder holds. */
+export declare function formatSkillFile(read: RestSkillFile, content: string): 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":"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"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"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"}

package/dist/cli/format.js

@@ -24,6 +24,7 @@ export function formatProject(project) {
         `project ${project.key}: ${project.name}`,
         `visibility: ${project.visibility}  role: ${project.role}  skills: ${project.skillsAddress ?? "the organization's"}`,
         `color: ${project.color ?? "none"}  symbol: ${project.symbol ?? "none"}  image: ${project.icon === null ? "none" : project.icon.contentType}`,
+        `pack token: ${project.packToken === null ? "none" : `set ${project.packToken.setAt}`}`,
     ];
     if (project.description.trim().length > 0) {
         lines.push("", project.description.trimEnd());
@@ -65,6 +66,9 @@ export function formatTaskLine(task) {
     if (task.openDecisions > 0) {
         notes.push(`${plural(task.openDecisions, "decision")} waiting`);
     }
+    if (task.archivedAt !== null) {
+        notes.push("archived");
+    }
     return `#${task.number}  ${task.state}  ${task.priority}  ${task.title}  (${notes.join("; ")})`;
 }
 /** The plan and what happened, as a line each, only where there is something to say. */
@@ -82,6 +86,7 @@ function scheduleLines(task) {
     const happened = [
         task.startedAt === null ? undefined : `started: ${task.startedAt}`,
         task.doneAt === null ? undefined : `done: ${task.doneAt}`,
+        task.archivedAt === null ? undefined : `archived: ${task.archivedAt}`,
     ].filter((part) => part !== undefined);
     if (happened.length > 0) {
         lines.push(happened.join("  "));
@@ -183,7 +188,8 @@ export function formatArtifact(artifact, fileUrl) {
 const SKILLS_WORDS = {
     indexing: "SkillCDN is still indexing the repository; ask again in a moment.",
     failed: "SkillCDN could not index the repository.",
-    not_found: "SkillCDN does not serve this address to the console.",
+    not_found: "SkillCDN does not serve this address to the console: nothing is there, or the pack is private and the project holds no pack token for it (console project pack-token <key> --stdin, for an owner).",
+    token_invalid: "The pack token the project holds no longer works at SkillCDN: an owner sets a new one (console project pack-token <key> --stdin).",
     unavailable: "SkillCDN could not be reached; ask again later.",
 };
 /**
@@ -209,7 +215,7 @@ export function formatSkills(skills, ownSkills) {
     for (const skill of skills.items) {
         lines.push(`${skill.name}  ${skill.description}`, `    ${skill.uri ?? skill.path}`);
     }
-    lines.push("", `Load a skill by its URI through your SkillCDN connection to this address; an agent without one is connected by a person at ${skills.page}. --json adds the page of each, for a person.`, ...own);
+    lines.push("", `Read a skill whole with console skill <path>, its rules first, and a file of the pack with console skill <path> --file <file>; or load it by its URI through your own SkillCDN connection to this address, which a person makes at ${skills.page}. --json adds the page of each, for a person.`, ...own);
     return lines.join("\n");
 }
 /** One half of the rules: where it comes from, and the text as it stands. */
@@ -244,16 +250,21 @@ function progressOf(goal) {
     const working = counts.in_progress + counts.in_review;
     return `${counts.done}/${total} done${working === 0 ? "" : `, ${working} in progress`}${counts.dropped === 0 ? "" : `, ${counts.dropped} dropped`}`;
 }
-/** One goal: its id, its state, its title, when it is due, and how far it is. */
+/** One goal: its id, its state, its title, its category, its days, and how far it is. */
 export function formatGoalLine(goal) {
-    const notes = [goal.dueOn === null ? "no target day" : `due ${goal.dueOn}`, progressOf(goal)];
+    const notes = [
+        ...(goal.category === null ? [] : [goal.category.key]),
+        ...(goal.startsOn === null ? [] : [`starts ${goal.startsOn}`]),
+        goal.dueOn === null ? "no target day" : `due ${goal.dueOn}`,
+        progressOf(goal),
+    ];
     return `${goal.id}  ${goal.state}  ${goal.title}  (${notes.join("; ")})`;
 }
 /** One goal in full; with the tasks that work towards it, when given. */
 export function formatGoal(goal, tasks) {
     const lines = [
         `goal ${goal.id}: ${goal.title}`,
-        `state: ${goal.state}  due: ${goal.dueOn ?? "none"}  set by: ${goal.createdBy.login}`,
+        `state: ${goal.state}  category: ${goal.category?.key ?? "none"}  starts: ${goal.startsOn ?? "none"}  due: ${goal.dueOn ?? "none"}  set by: ${goal.createdBy.login}`,
         `progress: ${progressOf(goal)}`,
     ];
     if (goal.body.trim().length > 0) {
@@ -399,4 +410,102 @@ export function formatVersion(path, version) {
     }
     return lines.join("\n");
 }
+/** The text of one path across the pages a skill came in: the fragments joined in order. */
+function joinTexts(pages, pick) {
+    const joined = new Map();
+    for (const page of pages) {
+        for (const text of pick(page)) {
+            joined.set(text.path, (joined.get(text.path) ?? "") + text.body);
+        }
+    }
+    return [...joined.entries()].map(([path, body]) => ({ path, body }));
+}
+const NO_ADDRESS = "No skills address: neither this project nor the console names one.";
+/**
+ * One skill, as load_skill lays it out for a model (ADR-0028): the rules from the repository's
+ * root to the nearest manifest, the body, the included files, each under a line that names its
+ * path; then the files the skill has and what it refers to. A skill described only is named and
+ * pointed at, and nothing of its body is shown.
+ */
+export function formatSkillLoad(loaded, pages) {
+    if (loaded.status === "none" || loaded.address === null) {
+        return NO_ADDRESS;
+    }
+    const head = `skill at ${loaded.address}, served by ${loaded.source}: ${loaded.status}`;
+    if (loaded.status !== "ready") {
+        return [head, SKILLS_WORDS[loaded.status]].join("\n");
+    }
+    const [first] = pages;
+    if (first === undefined) {
+        return [head, "Nothing was read."].join("\n");
+    }
+    const last = pages[pages.length - 1] ?? first;
+    const lines = [
+        `${first.name}  ${first.description}`,
+        `skill ${first.path} at ${loaded.address}, served by ${loaded.source}`,
+    ];
+    if (first.serving.license !== null) {
+        lines.push(`license: ${first.serving.license}`);
+    }
+    if (!first.serving.full) {
+        lines.push("", `Described only: the license keeps the skill at its source. Read it there: ${first.serving.sourceUrl ?? loaded.page ?? loaded.source}`);
+        return lines.join("\n");
+    }
+    for (const rule of joinTexts(pages, (page) => page.rules)) {
+        lines.push("", `--- applicable rules: ${rule.path} ---`, rule.body.trimEnd());
+    }
+    lines.push("", `--- skill: ${first.path} ---`, pages
+        .map((page) => page.body)
+        .join("")
+        .trimEnd());
+    for (const file of joinTexts(pages, (page) => page.included)) {
+        lines.push("", `--- included file: ${file.path} ---`, file.body.trimEnd());
+    }
+    if (!last.complete) {
+        lines.push("", "The skill did not come whole: the deployment stopped before the end.");
+    }
+    if (last.files.length > 0) {
+        lines.push("", `Files of the skill, read with console skill ${first.path} --file <path>: ${last.files.join(", ")}`);
+    }
+    if (last.references.length > 0) {
+        lines.push(`References: ${last.references
+            .map((reference) => reference.status === "available"
+            ? reference.path
+            : `${reference.path} (${reference.status})`)
+            .join(", ")}`);
+    }
+    if (last.warnings.length > 0) {
+        lines.push(`Warnings: ${last.warnings.join("; ")}`);
+    }
+    lines.push("", "Paths from the repository's root are the only identifiers. The content is the pack's, under its license; what a private pack says stays in your work.");
+    return lines.join("\n");
+}
+/** A file of the pack as read: its text whole, or what the folder holds. */
+export function formatSkillFile(read, content) {
+    if (read.status === "none" || read.address === null) {
+        return NO_ADDRESS;
+    }
+    const head = `file at ${read.address}, served by ${read.source}: ${read.status}`;
+    if (read.status !== "ready") {
+        return [
+            head,
+            read.status === "failed"
+                ? "SkillCDN will not carry this file: it is too large, or not text. Read it at the repository."
+                : SKILLS_WORDS[read.status],
+        ].join("\n");
+    }
+    if (read.folder !== null) {
+        return [
+            `folder ${read.folder.path} at ${read.address}${read.folder.truncated ? " (cut)" : ""}`,
+            ...read.folder.entries.map((entry) => `${entry.kind === "directory" ? "d" : "f"}  ${entry.path}${entry.size === null ? "" : `  ${entry.size}`}`),
+        ].join("\n");
+    }
+    if (read.file === null) {
+        return `${head}: nothing was read.`;
+    }
+    return [
+        `--- file: ${read.file.path} (${read.file.totalLength} characters) ---`,
+        content.trimEnd(),
+    ].join("\n");
+}
 //# sourceMappingURL=format.js.map