@inharness-ai/claude4spec 1.0.16 → 1.0.18

package/dist/shared/design-system.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pure, deterministic design-system token logic shared by the server (L2 service
+ * + L9 serializer) and the client (L5 live preview). No DB / no I/O — the single
+ * implementation of `resolve()` and `lintTokens()` referenced by the brief.
+ */
+import { type DesignMode, type DesignSystem, type DesignSystemListItem, type ResolvedTokenValue, type TokenGroup } from './entities.js';
+export declare function parseGroups(raw: string | unknown): TokenGroup[];
+export declare function parseModes(raw: string | unknown): DesignMode[];
+export declare function toListItem(ds: DesignSystem): DesignSystemListItem;
+export declare function aliasTarget(value: string): string | null;
+/**
+ * Resolve every token to its concrete value:
+ *   1. recursive `{token}` alias expansion with cycle detection → `unresolved`
+ *      (never throws),
+ *   2. active-mode overrides applied over base (Base = no overrides); unknown
+ *      override token ignored,
+ *   3. name → resolvedValue (object for composite tokens).
+ */
+export declare function resolve(groups: TokenGroup[], modes: DesignMode[], activeMode?: string): Record<string, ResolvedTokenValue>;
+export declare function lintTokens(groups: TokenGroup[], modes: DesignMode[]): string[];

package/dist/shared/design-system.js

@@ -0,0 +1,222 @@
+/**
+ * Pure, deterministic design-system token logic shared by the server (L2 service
+ * + L9 serializer) and the client (L5 live preview). No DB / no I/O — the single
+ * implementation of `resolve()` and `lintTokens()` referenced by the brief.
+ */
+import { COMPOSITE_TOKEN_TYPES, UNRESOLVED_TOKEN, } from './entities.js';
+// ─── parsing (tolerant of raw JSON strings or already-parsed arrays) ─────────
+function coerceArray(raw) {
+    if (Array.isArray(raw))
+        return raw;
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+function parseValue(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, String(v)]));
+    }
+    return '';
+}
+function parseToken(t) {
+    const o = (t ?? {});
+    const out = {
+        name: String(o.name ?? ''),
+        type: String(o.type ?? 'string'),
+        value: parseValue(o.value),
+    };
+    if (typeof o.description === 'string')
+        out.description = o.description;
+    return out;
+}
+export function parseGroups(raw) {
+    return coerceArray(raw)
+        .filter((g) => g !== null && typeof g === 'object')
+        .map((g) => ({
+        name: String(g.name ?? ''),
+        tier: g.tier === 'semantic' ? 'semantic' : 'primitive',
+        tokens: Array.isArray(g.tokens) ? g.tokens.map(parseToken) : [],
+    }));
+}
+export function parseModes(raw) {
+    return coerceArray(raw)
+        .filter((m) => m !== null && typeof m === 'object')
+        .map((m) => ({
+        name: String(m.name ?? ''),
+        overrides: Array.isArray(m.overrides)
+            ? m.overrides
+                .filter((o) => o !== null && typeof o === 'object')
+                .map((o) => ({ token: String(o.token ?? ''), value: parseValue(o.value) }))
+            : [],
+    }));
+}
+export function toListItem(ds) {
+    return {
+        slug: ds.slug,
+        name: ds.name,
+        description: ds.description,
+        groupCount: ds.groups.length,
+        tokenCount: ds.groups.reduce((acc, g) => acc + (g.tokens?.length ?? 0), 0),
+        modeCount: ds.modes.length,
+        tags: ds.tags,
+    };
+}
+// ─── resolve() ───────────────────────────────────────────────────────────────
+const ALIAS_RE = /^\{([^}]+)\}$/;
+export function aliasTarget(value) {
+    const m = ALIAS_RE.exec(value.trim());
+    return m ? m[1].trim() : null;
+}
+/**
+ * Resolve every token to its concrete value:
+ *   1. recursive `{token}` alias expansion with cycle detection → `unresolved`
+ *      (never throws),
+ *   2. active-mode overrides applied over base (Base = no overrides); unknown
+ *      override token ignored,
+ *   3. name → resolvedValue (object for composite tokens).
+ */
+export function resolve(groups, modes, activeMode) {
+    const base = new Map();
+    for (const g of groups ?? []) {
+        for (const t of g.tokens ?? []) {
+            if (t && typeof t.name === 'string' && t.name)
+                base.set(t.name, t.value);
+        }
+    }
+    if (activeMode) {
+        const mode = (modes ?? []).find((m) => m.name === activeMode);
+        if (mode) {
+            for (const ov of mode.overrides ?? []) {
+                if (base.has(ov.token))
+                    base.set(ov.token, ov.value);
+            }
+        }
+    }
+    const resolveValue = (value, seen) => {
+        if (typeof value === 'string') {
+            const target = aliasTarget(value);
+            if (target === null)
+                return value; // literal
+            if (seen.has(target) || !base.has(target))
+                return UNRESOLVED_TOKEN;
+            const next = new Set(seen);
+            next.add(target);
+            return resolveValue(base.get(target), next);
+        }
+        const out = {};
+        for (const [k, fieldVal] of Object.entries(value ?? {})) {
+            const r = resolveValue(typeof fieldVal === 'string' ? fieldVal : '', seen);
+            out[k] = typeof r === 'string' ? r : UNRESOLVED_TOKEN;
+        }
+        return out;
+    };
+    const result = {};
+    for (const [name, value] of base) {
+        result[name] = resolveValue(value, new Set([name]));
+    }
+    return result;
+}
+// ─── lintTokens() — warnings only; never blocks a write ──────────────────────
+function isComposite(type) {
+    return COMPOSITE_TOKEN_TYPES.includes(type);
+}
+function aliasTargetOf(t) {
+    if (!t || typeof t.value !== 'string')
+        return null;
+    return aliasTarget(t.value);
+}
+function detectCycles(base) {
+    const out = [];
+    const reported = new Set();
+    for (const start of base.keys()) {
+        const seen = [];
+        const seenSet = new Set();
+        let cur = start;
+        while (cur && base.has(cur)) {
+            if (seenSet.has(cur)) {
+                const idx = seen.indexOf(cur);
+                const cycle = seen.slice(idx).concat(cur);
+                const key = [...new Set(cycle)].sort().join('|');
+                if (!reported.has(key)) {
+                    reported.add(key);
+                    out.push(`Alias cycle: ${cycle.join(' → ')}`);
+                }
+                break;
+            }
+            seenSet.add(cur);
+            seen.push(cur);
+            cur = aliasTargetOf(base.get(cur));
+        }
+    }
+    return out;
+}
+export function lintTokens(groups, modes) {
+    const warnings = [];
+    const base = new Map();
+    const seenNames = new Set();
+    for (const g of groups ?? []) {
+        for (const t of g.tokens ?? []) {
+            if (!t || typeof t.name !== 'string' || !t.name)
+                continue;
+            if (seenNames.has(t.name))
+                warnings.push(`Duplicate token name '${t.name}'`);
+            seenNames.add(t.name);
+            base.set(t.name, t);
+        }
+    }
+    for (const g of groups ?? []) {
+        for (const t of g.tokens ?? []) {
+            if (!t || typeof t.name !== 'string' || !t.name)
+                continue;
+            const composite = isComposite(t.type);
+            if (t.value !== null && typeof t.value === 'object' && !composite) {
+                warnings.push(`Token '${t.name}': object value requires a composite type (typography|shadow), got '${t.type}'`);
+            }
+            if (typeof t.value === 'string' && composite) {
+                warnings.push(`Token '${t.name}': type '${t.type}' expects a composite object value, got a string`);
+            }
+            const aliasRefs = [];
+            if (typeof t.value === 'string') {
+                const target = aliasTarget(t.value);
+                if (target)
+                    aliasRefs.push(target);
+                else if (g.tier === 'semantic') {
+                    warnings.push(`note: semantic token '${t.name}' uses a literal value instead of an alias`);
+                }
+            }
+            else if (t.value && typeof t.value === 'object') {
+                for (const fv of Object.values(t.value)) {
+                    if (typeof fv === 'string') {
+                        const target = aliasTarget(fv);
+                        if (target)
+                            aliasRefs.push(target);
+                    }
+                }
+            }
+            for (const ref of aliasRefs) {
+                if (!base.has(ref)) {
+                    warnings.push(`Token '${t.name}': alias '{${ref}}' points to a non-existent token`);
+                }
+            }
+        }
+    }
+    warnings.push(...detectCycles(base));
+    for (const m of modes ?? []) {
+        for (const ov of m.overrides ?? []) {
+            if (!base.has(ov.token)) {
+                warnings.push(`Mode '${m.name}': override targets non-existent token '${ov.token}'`);
+            }
+        }
+    }
+    return [...new Set(warnings)];
+}
+//# sourceMappingURL=design-system.js.map

package/dist/shared/design-system.js.map

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

package/dist/shared/entities.d.ts

@@ -1,6 +1,6 @@
 import type { TodoItem, UsageStats } from '@inharness-ai/agent-adapters';
 export type { TodoItem, UsageStats };
-export type EntityType = 'endpoint' | 'dto' | 'database-table' | 'ui-view' | 'ac' | 'section';
+export type EntityType = 'endpoint' | 'dto' | 'database-table' | 'ui-view' | 'ac' | 'design-system' | 'section';
 export type ChangedBy = 'user' | 'agent';
 export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 export type EndpointDtoRelation = 'request' | 'response' | 'error';
@@ -194,6 +194,8 @@ export interface UiView {
     url: string | null;
     description: string | null;
     params: UiViewParam[];
+    /** v0.1.59: structural (non-tag) relation to a design-system. NULL = none. Slug, no FK. */
+    designSystemSlug: string | null;
     tags: string[];
     createdAt: string;
     updatedAt: string;
@@ -203,6 +205,8 @@ export interface UiViewCreateInput {
     url?: string | null;
     description?: string;
     params?: UiViewParam[];
+    /** v0.1.59: slug of the referenced design-system (no FK). undefined/null = none. */
+    designSystemSlug?: string | null;
     slug?: string;
     tags?: string[];
 }
@@ -211,6 +215,8 @@ export interface UiViewUpdateInput {
     url?: string | null;
     description?: string | null;
     params?: UiViewParam[];
+    /** v0.1.59: undefined = unchanged; null = clear; string = set (dangling allowed). */
+    designSystemSlug?: string | null;
     tags?: string[];
     newSlug?: string;
 }
@@ -225,6 +231,92 @@ export interface UiViewDeleteResult {
     deleted: true;
     brokenReferences: BrokenReference[];
 }
+export type TokenTier = 'primitive' | 'semantic';
+/** Best-effort vocabulary — the linter warns but never hard-validates `type`. */
+export type TokenType = 'color' | 'dimension' | 'fontFamily' | 'fontWeight' | 'fontSize' | 'lineHeight' | 'letterSpacing' | 'duration' | 'easing' | 'shadow' | 'opacity' | 'zIndex' | 'number' | 'string' | 'typography';
+/** Token types whose `value` is a composite object (each field literal or `{alias}`). */
+export declare const COMPOSITE_TOKEN_TYPES: readonly ["typography", "shadow"];
+/** Literal/alias string, or a composite object (typography/shadow). */
+export type TokenValue = string | Record<string, string>;
+export interface DesignToken {
+    name: string;
+    /** TokenType vocabulary, but typed loosely — linter is best-effort. */
+    type: string;
+    value: TokenValue;
+    description?: string;
+}
+export interface TokenGroup {
+    name: string;
+    tier: TokenTier;
+    tokens: DesignToken[];
+}
+export interface DesignModeOverride {
+    token: string;
+    value: TokenValue;
+}
+export interface DesignMode {
+    name: string;
+    overrides: DesignModeOverride[];
+}
+export interface DesignSystem {
+    slug: string;
+    name: string;
+    description: string | null;
+    groups: TokenGroup[];
+    modes: DesignMode[];
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DesignSystemCreateInput {
+    name: string;
+    description?: string;
+    groups?: TokenGroup[];
+    modes?: DesignMode[];
+    /** Optional explicit slug — used by M17 restore to preserve identity. */
+    slug?: string;
+    tags?: string[];
+}
+export interface DesignSystemUpdateInput {
+    name?: string;
+    description?: string | null;
+    /** Full replace of the array (not per-token patch). */
+    groups?: TokenGroup[];
+    /** Full replace of the array (not per-mode patch). */
+    modes?: DesignMode[];
+    tags?: string[];
+    newSlug?: string;
+}
+export interface DesignSystemListQuery {
+    tags?: string[];
+    tagFilter?: 'and' | 'or';
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Trimmed list row — counts computed server-side without the full token payload. */
+export interface DesignSystemListItem {
+    slug: string;
+    name: string;
+    description: string | null;
+    groupCount: number;
+    tokenCount: number;
+    modeCount: number;
+    tags: string[];
+}
+export interface DesignSystemDanglingUiView {
+    slug: string;
+}
+export interface DesignSystemDeleteResult {
+    deleted: true;
+    brokenReferences: BrokenReference[];
+    /** UI views whose `designSystemSlug` pointed at the deleted record (now dangling). */
+    danglingUiViews: DesignSystemDanglingUiView[];
+}
+/** Resolved token value: literal string, resolved composite object, or the `unresolved` sentinel. */
+export type ResolvedTokenValue = string | Record<string, string>;
+/** Sentinel for an alias that cannot be resolved (cycle / missing target). Preview never crashes. */
+export declare const UNRESOLVED_TOKEN = "unresolved";
 export interface Tag {
     slug: string;
     name: string;
@@ -467,6 +559,12 @@ export interface ChatThread {
     id: string;
     title: string | null;
     lastSessionId: string | null;
+    /** M05 0.1.61: turn-1 architecture snapshot (model + reasoning config). null until the
+     *  thread has a session; controls hydrate from this when session-locked. */
+    initialArchitectureConfig: {
+        model: string;
+        architectureConfig: Record<string, unknown>;
+    } | null;
     currentTodoItems: TodoItem[] | null;
     planMode: boolean;
     usage: UsageStats | null;
@@ -519,6 +617,34 @@ export interface Annotation {
         to: number;
     };
 }
+/**
+ * A message waiting in a thread's queue. **Frozen wire contract** — the field
+ * names must match `@inharness-ai/agent-chat`'s `QueuedMessage`, because the
+ * client hydrates queue chips from them. Derived from a `chat_queued_message`
+ * row: `id → String(id)`, `text = prompt`, `createdAt = created_at`.
+ */
+export interface QueuedMessage {
+    /** `String(chat_queued_message.id)` — key for cancel/chip. */
+    id: string;
+    /** `chat_queued_message.prompt`; restored to the composer on abort/clear. */
+    text: string;
+    /** ISO timestamp of when the message was enqueued. */
+    createdAt: string;
+}
+/** Body of `POST /api/chat/queue/:threadId` — same context as `POST /api/chat`. */
+export interface QueueMessageRequest {
+    prompt: string;
+    annotations?: Annotation[];
+    currentPage?: string | null;
+}
+/** Full queue snapshot after a mutation (enqueue/cancel) and carried by SSE `queue_updated`. */
+export interface QueueSnapshotResponse {
+    queued: QueuedMessage[];
+}
+/** Returned by `DELETE /api/chat/queue/:threadId` and attached to abort responses. */
+export interface ClearedQueueResponse {
+    clearedTexts: string[];
+}
 export type PlanExecuteMode = 'new-session' | 'continue';
 export type PlanAction = 'replace' | 'append' | 'insert_after_section' | 'user_edit' | 'system_duplicate';
 export type PlanChangedBy = 'agent' | 'user' | 'system';

package/dist/shared/entities.js

@@ -1,3 +1,7 @@
+/** Token types whose `value` is a composite object (each field literal or `{alias}`). */
+export const COMPOSITE_TOKEN_TYPES = ['typography', 'shadow'];
+/** Sentinel for an alias that cannot be resolved (cycle / missing target). Preview never crashes. */
+export const UNRESOLVED_TOKEN = 'unresolved';
 /** Reserved frontmatter keys agent cannot mutate via update_brief. */
 export const BRIEF_IMMUTABLE_FRONTMATTER_KEYS = [
     'type',

package/dist/shared/entities.js.map

@@ -1 +1 @@
-{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/shared/entities.ts"],"names":[],"mappings":"AA4pBA,sEAAsE;AACtE,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,MAAM;IACN,cAAc;IACd,YAAY;IACZ,cAAc;IACd,mBAAmB;CACX,CAAC;AAiFX;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,MAAM;IACN,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,YAAY;CACJ,CAAC"}
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/shared/entities.ts"],"names":[],"mappings":"AA8SA,yFAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAU,CAAC;AA8FvE,qGAAqG;AACrG,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAwb7C,sEAAsE;AACtE,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,MAAM;IACN,cAAc;IACd,YAAY;IACZ,cAAc;IACd,mBAAmB;CACX,CAAC;AAiFX;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,MAAM;IACN,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,YAAY;CACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inharness-ai/claude4spec",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "Plan the whole system before your agent writes a line of code. Local-first planning layer with structured entities and typed relations.",
   "license": "MIT",
   "author": "Mike Tomala <mike@inharness.ai>",
@@ -57,8 +57,8 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.109",
     "@google/gemini-cli-core": "^0.42.0",
-    "@inharness-ai/agent-adapters": "^0.6.4",
-    "@inharness-ai/agent-chat": "^0.3.0",
+    "@inharness-ai/agent-adapters": "^0.8.1",
+    "@inharness-ai/agent-chat": "^0.3.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@monaco-editor/react": "^4.7.0",
     "@openai/codex-sdk": "^0.130.0",

package/dist/client/assets/channel-zmRfuI3H.js

@@ -1 +0,0 @@
-import{ai as o,aj as n}from"./mermaid.core-JhUbsJFB.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};

package/dist/client/assets/classDiagram-4FO5ZUOK-B9RFgPu-.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-727SXJPM-TZenviWx.js";import{_ as i}from"./mermaid.core-JhUbsJFB.js";import"./chunk-FMBD7UC4-DLEErJWK.js";import"./chunk-ND2GUHAM-pKGgwz_0.js";import"./chunk-55IACEB6-8d1qQ5z6.js";import"./chunk-2J33WTMH-Cp08Xa7f.js";import"./index-DRFbyGvK.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};

package/dist/client/assets/classDiagram-v2-Q7XG4LA2-B9RFgPu-.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-727SXJPM-TZenviWx.js";import{_ as i}from"./mermaid.core-JhUbsJFB.js";import"./chunk-FMBD7UC4-DLEErJWK.js";import"./chunk-ND2GUHAM-pKGgwz_0.js";import"./chunk-55IACEB6-8d1qQ5z6.js";import"./chunk-2J33WTMH-Cp08Xa7f.js";import"./index-DRFbyGvK.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};