wicked-crew 0.16.11 → 0.16.13

package/dist/persona/routes.d.ts

@@ -0,0 +1,92 @@
+/**
+ * `/api/v1/persona` (program DES-LEARN §3.3): read and save the orchestrator's personality — the
+ * person's own (`scope=user`) and a project's override (`scope=project:<id>`). Reads are anyone's;
+ * a save or a removal is a PERSON's (the watch routes' human-operator predicate), audited.
+ */
+import type { FastifyInstance } from 'fastify';
+import { z } from 'zod';
+import type { CoreAdapter } from '../core/adapter.js';
+import type { AuditLog } from '../api/audit.js';
+import { type PersonaStore } from './store.js';
+export declare const PersonaPutSchema: z.ZodObject<{
+    scope: z.ZodString;
+    persona: z.ZodObject<{
+        name: z.ZodString;
+        colour: z.ZodString;
+        dials: z.ZodObject<{
+            length: z.ZodNumber;
+            warmth: z.ZodNumber;
+            pushback: z.ZodNumber;
+            initiative: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            length: number;
+            warmth: number;
+            pushback: number;
+            initiative: number;
+        }, {
+            length: number;
+            warmth: number;
+            pushback: number;
+            initiative: number;
+        }>;
+        habits: z.ZodArray<z.ZodEnum<["says-unchecked", "tables", "cites", "names"]>, "many">;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        colour: string;
+        dials: {
+            length: number;
+            warmth: number;
+            pushback: number;
+            initiative: number;
+        };
+        habits: ("names" | "says-unchecked" | "tables" | "cites")[];
+        notes?: string | undefined;
+    }, {
+        name: string;
+        colour: string;
+        dials: {
+            length: number;
+            warmth: number;
+            pushback: number;
+            initiative: number;
+        };
+        habits: ("names" | "says-unchecked" | "tables" | "cites")[];
+        notes?: string | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    scope: string;
+    persona: {
+        name: string;
+        colour: string;
+        dials: {
+            length: number;
+            warmth: number;
+            pushback: number;
+            initiative: number;
+        };
+        habits: ("names" | "says-unchecked" | "tables" | "cites")[];
+        notes?: string | undefined;
+    };
+}, {
+    scope: string;
+    persona: {
+        name: string;
+        colour: string;
+        dials: {
+            length: number;
+            warmth: number;
+            pushback: number;
+            initiative: number;
+        };
+        habits: ("names" | "says-unchecked" | "tables" | "cites")[];
+        notes?: string | undefined;
+    };
+}>;
+export interface PersonaRouteDeps {
+    store: PersonaStore;
+    adapter: Pick<CoreAdapter, 'projectGet'>;
+    audit: AuditLog;
+}
+export declare function registerPersonaRoutes(app: FastifyInstance, deps: PersonaRouteDeps): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/persona/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/persona/routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAgD,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAK7F,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAwF,CAAC;AAEtH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACzC,KAAK,EAAE,QAAQ,CAAC;CACjB;AAKD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CA+DxF"}

package/dist/persona/routes.js

@@ -0,0 +1,69 @@
+/**
+ * `/api/v1/persona` (program DES-LEARN §3.3): read and save the orchestrator's personality — the
+ * person's own (`scope=user`) and a project's override (`scope=project:<id>`). Reads are anyone's;
+ * a save or a removal is a PERSON's (the watch routes' human-operator predicate), audited.
+ */
+import { z } from 'zod';
+import { API_PREFIX } from '../api/api-prefix.js';
+import { LOCAL_ACTOR } from '../api/auth.js';
+import { isHumanOperator } from '../api/watch-routes.js';
+import { parseScope, PersonaInputSchema } from './store.js';
+import { voiceBlock } from './voice.js';
+const V = API_PREFIX;
+export const PersonaPutSchema = z.object({ scope: z.string().min(1).max(200), persona: PersonaInputSchema }).strict();
+const voices = (m) => Object.fromEntries(Object.entries(m).map(([k, p]) => [k, voiceBlock(p)]));
+export function registerPersonaRoutes(app, deps) {
+    const actorOf = (req) => req.actor ?? LOCAL_ACTOR;
+    const refuse = (reply) => reply.code(403).send({ error: 'Only a person can change a personality (a worker or system actor cannot)' });
+    const projectKnown = async (scope) => !scope.startsWith('project:') || (await deps.adapter.projectGet(scope.slice('project:'.length))) !== null;
+    app.get(`${V}/persona`, { config: { manifest: { responseType: 'PersonaResponse', statusCodes: [200] } } }, async () => {
+        const user = deps.store.userPersona();
+        const projects = deps.store.overrides();
+        return { user, projects, voice: { user: user === null ? null : voiceBlock(user), projects: voices(projects) } };
+    });
+    app.put(`${V}/persona`, { config: { manifest: { requestType: 'PersonaPutBody', responseType: 'PersonaSaved', statusCodes: [200, 400, 403, 404, 500] } } }, async (req, reply) => {
+        const actor = actorOf(req);
+        if (!isHumanOperator(actor))
+            return refuse(reply);
+        const parsed = PersonaPutSchema.safeParse(req.body);
+        if (!parsed.success) {
+            return reply.code(400).send({ error: parsed.error.issues.map((i) => `${i.path.join('.') || 'body'}: ${i.message}`).join('; ') });
+        }
+        const scope = parseScope(parsed.data.scope);
+        if (scope === null)
+            return reply.code(400).send({ error: 'scope is "user" or "project:<id>"' });
+        if (!(await projectKnown(scope)))
+            return reply.code(404).send({ error: `no project '${scope.slice('project:'.length)}'` });
+        let persona;
+        try {
+            persona = deps.store.save(scope, parsed.data.persona);
+        }
+        catch (err) {
+            return reply.code(500).send({ error: `the personality could not be saved: ${err instanceof Error ? err.message : String(err)}` });
+        }
+        deps.audit.record('persona.saved', actor, { detail: { scope, version: persona.version } });
+        return { scope, persona, voice: voiceBlock(persona) };
+    });
+    app.delete(`${V}/persona`, { config: { manifest: { responseType: 'PersonaRemoved', statusCodes: [200, 400, 403, 404, 500] } } }, async (req, reply) => {
+        const actor = actorOf(req);
+        if (!isHumanOperator(actor))
+            return refuse(reply);
+        const raw = req.query.scope;
+        const scope = parseScope(Array.isArray(raw) ? raw[0] : raw);
+        if (scope === null || scope === 'user') {
+            return reply.code(400).send({ error: 'only a project override can be removed: scope=project:<id>' });
+        }
+        let removed;
+        try {
+            removed = deps.store.remove(scope.slice('project:'.length));
+        }
+        catch (err) {
+            return reply.code(500).send({ error: `the override could not be removed: ${err instanceof Error ? err.message : String(err)}` });
+        }
+        if (!removed)
+            return reply.code(404).send({ error: `${scope} has no override` });
+        deps.audit.record('persona.removed', actor, { detail: { scope } });
+        return { removed: true, scope };
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/persona/routes.js.map

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

package/dist/persona/store.d.ts

@@ -0,0 +1,104 @@
+/**
+ * THE ORCHESTRATOR'S PERSONALITY (program DES-LEARN §3.3): how the agent that talks to the person
+ * speaks — one record for the person (`user`), and an optional override per project, started as a
+ * copy of theirs. A personality changes tone only: it is never read by a gate, a review, QE or a
+ * rule check, and nothing here can widen what a seat may do.
+ *
+ * Persisted as ONE file, `<state home>/daemon-persona.json`, under the registered `daemon-` prefix
+ * (as `editors/registry.ts` keeps `daemon-editors.json`): a new top-level entry outside that prefix
+ * is one core's worker fence refuses. Written atomically (temp file + rename), read once at boot.
+ */
+import { z } from 'zod';
+export declare const PERSONA_STATE_FILENAME = "daemon-persona.json";
+/** The four dials: 0 = the left word, 2 = the right word. */
+export declare const PERSONA_DIALS: readonly ["length", "warmth", "pushback", "initiative"];
+export type PersonaDialName = (typeof PERSONA_DIALS)[number];
+/** The habits a person can tick. */
+export declare const PERSONA_HABITS: readonly ["says-unchecked", "tables", "cites", "names"];
+export type PersonaHabit = (typeof PERSONA_HABITS)[number];
+/** What a person sends (`PUT /persona`): the server adds `version` and `updatedAt`. */
+export declare const PersonaInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    colour: z.ZodString;
+    dials: z.ZodObject<{
+        length: z.ZodNumber;
+        warmth: z.ZodNumber;
+        pushback: z.ZodNumber;
+        initiative: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        length: number;
+        warmth: number;
+        pushback: number;
+        initiative: number;
+    }, {
+        length: number;
+        warmth: number;
+        pushback: number;
+        initiative: number;
+    }>;
+    habits: z.ZodArray<z.ZodEnum<["says-unchecked", "tables", "cites", "names"]>, "many">;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    colour: string;
+    dials: {
+        length: number;
+        warmth: number;
+        pushback: number;
+        initiative: number;
+    };
+    habits: ("names" | "says-unchecked" | "tables" | "cites")[];
+    notes?: string | undefined;
+}, {
+    name: string;
+    colour: string;
+    dials: {
+        length: number;
+        warmth: number;
+        pushback: number;
+        initiative: number;
+    };
+    habits: ("names" | "says-unchecked" | "tables" | "cites")[];
+    notes?: string | undefined;
+}>;
+export type PersonaInput = z.infer<typeof PersonaInputSchema>;
+export interface Persona extends PersonaInput {
+    /** Starts at 1, one more on every save of this scope. */
+    version: number;
+    /** Unix ms of the save. */
+    updatedAt: number;
+}
+/** `user`, or `project:<id>` (an override for one project). */
+export type PersonaScope = 'user' | `project:${string}`;
+/** The scope a query or body names, or null when it is not one. */
+export declare function parseScope(raw: unknown): PersonaScope | null;
+export declare class PersonaStore {
+    private readonly file;
+    private user;
+    private readonly projects;
+    private readonly log;
+    constructor(opts?: {
+        stateHome?: string;
+        log?: (m: string) => void;
+    });
+    /** Where the record lives (diagnostics / tests). */
+    get path(): string;
+    private load;
+    private write;
+    /** The person's own personality, or null before one is saved. */
+    userPersona(): Persona | null;
+    /** Every project override, by project id. */
+    overrides(): Record<string, Persona>;
+    /** The personality a talk in `projectId` uses: the project's override, else the person's, else none. */
+    effective(projectId: string | null): {
+        persona: Persona;
+        scope: PersonaScope;
+    } | null;
+    /** Save one scope; the version is one more than that scope's last. Throws when the write fails
+     *  (the in-memory record is rolled back, so a failed save never reads as saved). */
+    save(scope: PersonaScope, input: PersonaInput, now?: number): Persona;
+    /** Remove a project's override (the person's own is never removed here). True when there was one. */
+    remove(projectId: string): boolean;
+    private put;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/persona/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/persona/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,6DAA6D;AAC7D,eAAO,MAAM,aAAa,yDAA0D,CAAC;AACrF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,oCAAoC;AACpC,eAAO,MAAM,cAAc,yDAA0D,CAAC;AACtF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAI3D,uFAAuF;AACvF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUpB,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,WAAW,OAAQ,SAAQ,YAAY;IAC3C,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,MAAM,EAAE,CAAC;AAIxD,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAK5D;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;gBAE9B,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAO;IAMxE,oDAAoD;IACpD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,IAAI;IA+BZ,OAAO,CAAC,KAAK;IAUb,iEAAiE;IACjE,WAAW,IAAI,OAAO,GAAG,IAAI;IAI7B,6CAA6C;IAC7C,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpC,wGAAwG;IACxG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAQrF;wFACoF;IACpF,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO;IAoBjF,qGAAqG;IACrG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAalC,OAAO,CAAC,GAAG;CASZ"}

package/dist/persona/store.js

@@ -0,0 +1,176 @@
+/**
+ * THE ORCHESTRATOR'S PERSONALITY (program DES-LEARN §3.3): how the agent that talks to the person
+ * speaks — one record for the person (`user`), and an optional override per project, started as a
+ * copy of theirs. A personality changes tone only: it is never read by a gate, a review, QE or a
+ * rule check, and nothing here can widen what a seat may do.
+ *
+ * Persisted as ONE file, `<state home>/daemon-persona.json`, under the registered `daemon-` prefix
+ * (as `editors/registry.ts` keeps `daemon-editors.json`): a new top-level entry outside that prefix
+ * is one core's worker fence refuses. Written atomically (temp file + rename), read once at boot.
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { crewStateHome } from '../projects/state-home.js';
+export const PERSONA_STATE_FILENAME = 'daemon-persona.json';
+/** The four dials: 0 = the left word, 2 = the right word. */
+export const PERSONA_DIALS = ['length', 'warmth', 'pushback', 'initiative'];
+/** The habits a person can tick. */
+export const PERSONA_HABITS = ['says-unchecked', 'tables', 'cites', 'names'];
+const Dial = z.number().int().min(0).max(2);
+/** What a person sends (`PUT /persona`): the server adds `version` and `updatedAt`. */
+export const PersonaInputSchema = z
+    .object({
+    // One line of plain text: a line break or control character could open a section of its own in the
+    // chat statement the voice block rides (codex + agy on #1236).
+    name: z.string().trim().min(1).max(40).regex(/^[^\p{Cc}\p{Zl}\p{Zp}]+$/u, 'name is one line of text'),
+    colour: z.string().regex(/^#[0-9a-fA-F]{6}$/u, 'colour is a #rrggbb hex'),
+    dials: z.object({ length: Dial, warmth: Dial, pushback: Dial, initiative: Dial }).strict(),
+    habits: z.array(z.enum(PERSONA_HABITS)).max(PERSONA_HABITS.length),
+    notes: z.string().trim().max(500).optional(),
+})
+    .strict();
+const PROJECT_ID = /^[A-Za-z0-9._-]{1,128}$/u;
+/** The scope a query or body names, or null when it is not one. */
+export function parseScope(raw) {
+    if (raw === 'user')
+        return 'user';
+    if (typeof raw !== 'string' || !raw.startsWith('project:'))
+        return null;
+    const id = raw.slice('project:'.length);
+    return PROJECT_ID.test(id) ? `project:${id}` : null;
+}
+const StoredSchema = PersonaInputSchema.extend({
+    version: z.number().int().min(1),
+    updatedAt: z.number().int().min(0),
+}).strict();
+export class PersonaStore {
+    file;
+    user = null;
+    projects = new Map();
+    log;
+    constructor(opts = {}) {
+        this.file = join(opts.stateHome ?? crewStateHome(), PERSONA_STATE_FILENAME);
+        this.log = opts.log ?? (() => undefined);
+        this.load();
+    }
+    /** Where the record lives (diagnostics / tests). */
+    get path() {
+        return this.file;
+    }
+    load() {
+        let text;
+        try {
+            text = readFileSync(this.file, 'utf8');
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                this.log(`[persona] ${PERSONA_STATE_FILENAME} unreadable: ${String(err)}`);
+            return;
+        }
+        let raw;
+        try {
+            raw = JSON.parse(text);
+        }
+        catch {
+            this.log(`[persona] ${PERSONA_STATE_FILENAME} is not JSON; starting with no personality`);
+            return;
+        }
+        const o = (raw ?? {});
+        const user = StoredSchema.safeParse(o['user']);
+        if (o['user'] !== undefined) {
+            if (user.success)
+                this.user = user.data;
+            else
+                this.log(`[persona] the user personality in ${PERSONA_STATE_FILENAME} is malformed; ignored`);
+        }
+        const projects = o['projects'];
+        if (projects !== null && typeof projects === 'object' && !Array.isArray(projects)) {
+            for (const [id, p] of Object.entries(projects)) {
+                const parsed = StoredSchema.safeParse(p);
+                if (PROJECT_ID.test(id) && parsed.success)
+                    this.projects.set(id, parsed.data);
+                else
+                    this.log(`[persona] project ${id}'s personality in ${PERSONA_STATE_FILENAME} is malformed; ignored`);
+            }
+        }
+    }
+    write() {
+        const state = { v: 1 };
+        if (this.user !== null)
+            state.user = this.user;
+        if (this.projects.size > 0)
+            state.projects = Object.fromEntries([...this.projects].sort(([a], [b]) => a.localeCompare(b)));
+        mkdirSync(join(this.file, '..'), { recursive: true });
+        const tmp = `${this.file}.${process.pid}.tmp`;
+        writeFileSync(tmp, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
+        renameSync(tmp, this.file);
+    }
+    /** The person's own personality, or null before one is saved. */
+    userPersona() {
+        return this.user;
+    }
+    /** Every project override, by project id. */
+    overrides() {
+        return Object.fromEntries(this.projects);
+    }
+    /** The personality a talk in `projectId` uses: the project's override, else the person's, else none. */
+    effective(projectId) {
+        if (projectId !== null) {
+            const p = this.projects.get(projectId);
+            if (p !== undefined)
+                return { persona: p, scope: `project:${projectId}` };
+        }
+        return this.user === null ? null : { persona: this.user, scope: 'user' };
+    }
+    /** Save one scope; the version is one more than that scope's last. Throws when the write fails
+     *  (the in-memory record is rolled back, so a failed save never reads as saved). */
+    save(scope, input, now = Date.now()) {
+        const prev = scope === 'user' ? this.user : this.projects.get(scope.slice('project:'.length)) ?? null;
+        const next = {
+            ...input,
+            habits: [...new Set(input.habits)],
+            ...(input.notes !== undefined && input.notes !== '' ? { notes: input.notes } : { notes: undefined }),
+            version: (prev?.version ?? 0) + 1,
+            updatedAt: now,
+        };
+        if (next.notes === undefined)
+            delete next.notes;
+        this.put(scope, next);
+        try {
+            this.write();
+        }
+        catch (err) {
+            this.put(scope, prev);
+            throw err;
+        }
+        return next;
+    }
+    /** Remove a project's override (the person's own is never removed here). True when there was one. */
+    remove(projectId) {
+        const prev = this.projects.get(projectId);
+        if (prev === undefined)
+            return false;
+        this.projects.delete(projectId);
+        try {
+            this.write();
+        }
+        catch (err) {
+            this.projects.set(projectId, prev);
+            throw err;
+        }
+        return true;
+    }
+    put(scope, p) {
+        if (scope === 'user') {
+            this.user = p;
+            return;
+        }
+        const id = scope.slice('project:'.length);
+        if (p === null)
+            this.projects.delete(id);
+        else
+            this.projects.set(id, p);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/persona/store.js.map

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

package/dist/persona/voice.d.ts

@@ -0,0 +1,4 @@
+import type { Persona } from './store.js';
+/** The voice block for one personality (markdown, a `## Voice` section). */
+export declare function voiceBlock(p: Persona): string;
+//# sourceMappingURL=voice.d.ts.map

package/dist/persona/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/persona/voice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAC;AAqCxD,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAsB7C"}

package/dist/persona/voice.js

@@ -0,0 +1,58 @@
+/**
+ * The VOICE BLOCK (program DES-LEARN §3.3): the short section a personality adds to what the agent
+ * that talks to the person is told (every chat's scope statement, the system chat's included). One
+ * template, so what `GET /persona` shows as `voice` is exactly what a seat reads.
+ *
+ * The first line after the heading is the invariant, said to the seat in so many words: tone only.
+ */
+const LENGTH = [
+    'Keep it short: lead with the answer, in at most three sentences unless asked for more.',
+    'Say enough to be clear, and no more.',
+    'Be thorough: give the steps and the reasoning behind them.',
+];
+const WARMTH = [
+    'Plain and direct: no pleasantries, no exclamation marks.',
+    'Friendly and calm.',
+    'Warm and encouraging.',
+];
+const PUSHBACK = [
+    'Go along with what is asked; raise a concern only when it blocks the work.',
+    'Name a concern when you see one, briefly.',
+    'Challenge: when you disagree, say so plainly and why, and say what you would do instead.',
+];
+const INITIATIVE = [
+    'Ask before you start anything.',
+    'Propose the next step and ask whether to take it.',
+    'When the next step is obvious and allowed, take it and say that you did.',
+];
+const HABITS = {
+    'says-unchecked': 'Say what you did not check.',
+    tables: 'Use a table when you compare options.',
+    cites: 'Cite the file and line for a claim about code.',
+    names: 'Address the person by name when you know it.',
+};
+/** The voice block for one personality (markdown, a `## Voice` section). */
+export function voiceBlock(p) {
+    // The schema refuses a multi-line name; a record that predates it is still flattened here.
+    const name = p.name.replace(/\s+/gu, ' ').trim();
+    const lines = [
+        '## Voice',
+        '',
+        'This section changes how you talk to the person, never what you may do: rules, gates, reviews and QE',
+        'are exactly as they are without it.',
+        '',
+        `- Your name with the person is "${name}".`,
+        '',
+        `- ${LENGTH[p.dials.length]}`,
+        `- ${WARMTH[p.dials.warmth]}`,
+        `- ${PUSHBACK[p.dials.pushback]}`,
+        `- ${INITIATIVE[p.dials.initiative]}`,
+        ...p.habits.map((h) => `- ${HABITS[h]}`),
+    ];
+    if (p.notes !== undefined && p.notes.trim() !== '') {
+        // The person's own words, quoted as a note about tone: one line, so it cannot open a new section.
+        lines.push(`- The person adds, about how to talk to them: "${p.notes.replace(/\s+/gu, ' ').trim()}"`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=voice.js.map

package/dist/persona/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/persona/voice.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,MAAM,MAAM,GAAG;IACb,wFAAwF;IACxF,sCAAsC;IACtC,4DAA4D;CACpD,CAAC;AACX,MAAM,MAAM,GAAG;IACb,0DAA0D;IAC1D,oBAAoB;IACpB,uBAAuB;CACf,CAAC;AACX,MAAM,QAAQ,GAAG;IACf,4EAA4E;IAC5E,2CAA2C;IAC3C,0FAA0F;CAClF,CAAC;AACX,MAAM,UAAU,GAAG;IACjB,gCAAgC;IAChC,mDAAmD;IACnD,0EAA0E;CAClE,CAAC;AACX,MAAM,MAAM,GAAiC;IAC3C,gBAAgB,EAAE,6BAA6B;IAC/C,MAAM,EAAE,uCAAuC;IAC/C,KAAK,EAAE,gDAAgD;IACvD,KAAK,EAAE,8CAA8C;CACtD,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,2FAA2F;IAC3F,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG;QACZ,UAAU;QACV,EAAE;QACF,sGAAsG;QACtG,qCAAqC;QACrC,EAAE;QACF,mCAAmC,IAAI,IAAI;QAC3C,EAAE;QACF,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QAC7B,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QAC7B,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;QACjC,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE;QACrC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;KACzC,CAAC;IACF,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,kGAAkG;QAClG,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/dist/projects/routes.d.ts

@@ -55,14 +55,14 @@ export declare const UpdateProjectSchema: z.ZodObject<{
     /** crew#552 — override `onboardingAutoCapture` for this project; null clears it. Crew-side. */
     autoCapture: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
 }, "strict", z.ZodTypeAny, {
-    status?: "active" | "archived" | undefined;
     name?: string | undefined;
+    status?: "active" | "archived" | undefined;
     description?: string | undefined;
     autoCapture?: boolean | null | undefined;
     interactiveRoot?: string | null | undefined;
 }, {
-    status?: "active" | "archived" | undefined;
     name?: string | undefined;
+    status?: "active" | "archived" | undefined;
     description?: string | undefined;
     autoCapture?: boolean | null | undefined;
     interactiveRoot?: string | null | undefined;

package/dist/setup/known.d.ts

@@ -0,0 +1,56 @@
+/**
+ * WHAT STUDIO ALREADY KNOWS (program DES-LEARN §4, first run): the facts the first-run flow shows
+ * before it asks anything — the git identity, the languages of the registered repositories, and the
+ * repositories found near them that are not registered yet. Read-only and bounded: every git call
+ * has a timeout and an output cap, the folder scan is one level deep under a closed list of roots,
+ * and a fact that cannot be read is `null` / empty, never a guess.
+ */
+import type { RepoEntry } from 'wicked-crew-api-types';
+export interface KnownLanguage {
+    name: string;
+    files: number;
+    /** Share of the counted source files, 0..1. */
+    share: number;
+}
+export interface NearbyRepo {
+    name: string;
+    path: string;
+}
+export interface SetupKnown {
+    git: {
+        name: string | null;
+        email: string | null;
+    } | null;
+    languages: KnownLanguage[];
+    /** Files counted across the registered repositories (source files only). */
+    filesCounted: number;
+    nearby: NearbyRepo[];
+}
+/** At most this many languages are named; the rest is "other". */
+export declare const MAX_LANGUAGES = 6;
+/** At most this many nearby repositories are offered. */
+export declare const MAX_NEARBY = 24;
+/** The folders a first run looks in, under the home directory (one level deep). */
+export declare const NEARBY_ROOTS: readonly ["code", "src", "Projects", "projects", "dev", "git", "repos", "workspace", "work"];
+/** The global git identity (the user's ~/.gitconfig, or GIT_CONFIG_GLOBAL when the environment names one). */
+export declare function gitIdentity(home?: string): Promise<SetupKnown['git']>;
+/** Count tracked source files by language in each repository (`git ls-files`, bounded). */
+export declare function languagesOf(repos: readonly Pick<RepoEntry, 'root_path'>[]): Promise<{
+    languages: KnownLanguage[];
+    files: number;
+}>;
+/** At most this many folder entries are looked at across every root, and the scan stops after this long:
+ *  the response cap alone would not bound the work (codex on #1236). */
+export declare const NEARBY_MAX_ENTRIES = 2000;
+export declare const NEARBY_DEADLINE_MS = 1500;
+/**
+ * Git checkouts one level under the closed roots (the home's usual code folders, and the folders the
+ * registered repositories sit in), minus the registered ones. Every path is compared CANONICALLY
+ * (`realpath`): a root or a child that resolves outside the home, or to the home itself, is skipped, so a
+ * symlink can never widen the scan. Hidden folders are skipped; a root that cannot be listed is skipped.
+ * Bounded by {@link NEARBY_MAX_ENTRIES} entries and {@link NEARBY_DEADLINE_MS}; sorted by name, at most
+ * {@link MAX_NEARBY}.
+ */
+export declare function nearbyRepos(registered: readonly Pick<RepoEntry, 'root_path'>[], home?: string, now?: () => number): Promise<NearbyRepo[]>;
+export declare function setupKnown(repos: readonly RepoEntry[], home?: string): Promise<SetupKnown>;
+//# sourceMappingURL=known.d.ts.map

package/dist/setup/known.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known.d.ts","sourceRoot":"","sources":["../../src/setup/known.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAeD,kEAAkE;AAClE,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,yDAAyD;AACzD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,mFAAmF;AACnF,eAAO,MAAM,YAAY,8FAA+F,CAAC;AAqBzH,8GAA8G;AAC9G,wBAAsB,WAAW,CAAC,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAGtF;AAED,2FAA2F;AAC3F,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBxI;AAED;wEACwE;AACxE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAoBvC;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,SAAS,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,EACnD,IAAI,GAAE,MAAkB,EACxB,GAAG,GAAE,MAAM,MAAiB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAmCvB;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAG3G"}