ccdesk 0.2.1 → 0.2.3

package/dist/shared/compare.d.ts

@@ -0,0 +1,25 @@
+import { type Scope } from "./types.ts";
+/** The value a key has in one directory, and the settings files it comes from. */
+export interface ComparedValue {
+    /** As ccdesk shows it, with hidden values as •••. */
+    value: unknown;
+    /** The files that decide it, lowest precedence first; several when lists or objects are combined. */
+    sources: Array<{
+        scope: Scope;
+        path: string;
+    }>;
+}
+export interface ComparedSetting {
+    key: string;
+    /** Null where no settings file Claude Code reads there sets the key. */
+    a: ComparedValue | null;
+    b: ComparedValue | null;
+    /** Whether both have the same value as ccdesk shows it; two hidden values count as the same. */
+    same: boolean;
+}
+/** The effective settings of two directories, key by key. */
+export interface SettingsComparison {
+    a: string;
+    b: string;
+    settings: ComparedSetting[];
+}

package/dist/shared/memory.d.ts

@@ -0,0 +1,2 @@
+/** Claude Code names a project's store after its path with every non-alphanumeric character as "-". */
+export declare function storeDirName(projectPath: string): string;

package/dist/shared/requests.d.ts

@@ -0,0 +1,104 @@
+import { type Static, Type } from "typebox";
+/** Set one top-level key in one settings file; `value` undefined removes the key. */
+export declare const SettingsEditBody: Type.TObject<{
+    dir: Type.TString;
+    scope: Type.TEnum<import("./types.ts").Scope[]>;
+    key: Type.TString;
+    value: Type.TOptional<Type.TUnknown>;
+}>;
+export type SettingsEdit = Static<typeof SettingsEditBody>;
+/** Take one permission rule out of its list and/or add one, in one settings file. */
+export declare const PermissionEditBody: Type.TObject<{
+    dir: Type.TString;
+    file: Type.TString;
+    remove: Type.TOptional<Type.TObject<{
+        list: Type.TEnum<import("./types.ts").PermissionList[]>;
+        rule: Type.TString;
+    }>>;
+    add: Type.TOptional<Type.TObject<{
+        list: Type.TEnum<import("./types.ts").PermissionList[]>;
+        rule: Type.TString;
+    }>>;
+}>;
+export type PermissionEdit = Static<typeof PermissionEditBody>;
+/**
+ * One hook change to a settings file. With both, the hook is replaced in place when it stays in
+ * the same event and matcher, and moved otherwise.
+ */
+export declare const HookEditBody: Type.TObject<{
+    dir: Type.TString;
+    file: Type.TString;
+    /** The hook to take out, as the scan showed it; refused when the file no longer has it there. */
+    remove: Type.TOptional<Type.TObject<{
+        event: Type.TString;
+        at: Type.TObject<{
+            group: Type.TInteger;
+            index: Type.TInteger;
+        }>;
+        definition: Type.TUnknown;
+    }>>;
+    /** The hook to write: the matcher group it goes in, and the hook itself. */
+    add: Type.TOptional<Type.TObject<{
+        event: Type.TString;
+        /** Empty or absent for a group without a matcher, which matches everything. */
+        matcher: Type.TOptional<Type.TString>;
+        definition: Type.TUnknown;
+    }>>;
+}>;
+export type HookEdit = Static<typeof HookEditBody>;
+/** One subagent file change: a new agent, a changed one, or one deleted. */
+export declare const AgentEditBody: Type.TObject<{
+    dir: Type.TString;
+    /** An agent the scan shows here; absent when creating one. */
+    path: Type.TOptional<Type.TString>;
+    /** Where a new agent goes, and its file name without .md. */
+    create: Type.TOptional<Type.TObject<{
+        scope: Type.TEnum<["user", "project"]>;
+        file: Type.TString;
+    }>>;
+    /** The whole file; null deletes the agent. */
+    text: Type.TUnion<[Type.TString, Type.TNull]>;
+}>;
+export type AgentEdit = Static<typeof AgentEditBody>;
+/**
+ * One MCP server change. Project servers are changed in .mcp.json; user and local ones through
+ * `claude mcp`. With both, the server is replaced, keeping its place in .mcp.json.
+ */
+export declare const McpEditBody: Type.TObject<{
+    dir: Type.TString;
+    scope: Type.TEnum<["user", "local", "project"]>;
+    /** The server to take out, as the scan showed it; refused when it changed since. */
+    remove: Type.TOptional<Type.TObject<{
+        name: Type.TString;
+        definition: Type.TUnknown;
+    }>>;
+    add: Type.TOptional<Type.TObject<{
+        name: Type.TString;
+        definition: Type.TUnknown;
+    }>>;
+}>;
+export type McpEdit = Static<typeof McpEditBody>;
+/** A save's or restore's revision: the one its preview returned. */
+export declare const RevisionBody: Type.TObject<{
+    revision: Type.TString;
+}>;
+/** Count which permission rules the transcripts under `path` used. */
+export declare const UsageBody: Type.TObject<{
+    path: Type.TString;
+    rules: Type.TArray<Type.TObject<{
+        list: Type.TEnum<import("./types.ts").PermissionList[]>;
+        rule: Type.TString;
+    }>>;
+}>;
+/** Preview a memory change; changing it also sends the revision. */
+export declare const MemoryBody: Type.TObject<{
+    action: Type.TString;
+    path: Type.TString;
+}>;
+export declare const OpenBody: Type.TObject<{
+    path: Type.TString;
+}>;
+/** Preview restoring a backup; restoring it also sends the revision. */
+export declare const BackupBody: Type.TObject<{
+    id: Type.TString;
+}>;

package/dist/shared/requests.js

@@ -0,0 +1,73 @@
+// What each API request sends, as JSON Schema. The server checks bodies against these, and each
+// type is read from its schema. The page imports only the types, re-exported from types.ts, so
+// TypeBox stays out of its bundle.
+import { Type } from "typebox";
+import { EVERY_FILE, PERMISSION_LISTS } from "./scopes.js";
+/** Set one top-level key in one settings file; `value` undefined removes the key. */
+export const SettingsEditBody = Type.Object({
+    dir: Type.String(),
+    scope: Type.Enum(EVERY_FILE),
+    key: Type.String(),
+    value: Type.Optional(Type.Unknown()),
+});
+/** One permission rule. */
+const Rule = Type.Object({ list: Type.Enum(PERMISSION_LISTS), rule: Type.String() });
+/** Take one permission rule out of its list and/or add one, in one settings file. */
+export const PermissionEditBody = Type.Object({
+    dir: Type.String(),
+    file: Type.String(),
+    remove: Type.Optional(Rule),
+    add: Type.Optional(Rule),
+});
+const place = Type.Integer({ minimum: 0 });
+/**
+ * One hook change to a settings file. With both, the hook is replaced in place when it stays in
+ * the same event and matcher, and moved otherwise.
+ */
+export const HookEditBody = Type.Object({
+    dir: Type.String(),
+    file: Type.String(),
+    /** The hook to take out, as the scan showed it; refused when the file no longer has it there. */
+    remove: Type.Optional(Type.Object({
+        event: Type.String(),
+        at: Type.Object({ group: place, index: place }),
+        definition: Type.Unknown(),
+    })),
+    /** The hook to write: the matcher group it goes in, and the hook itself. */
+    add: Type.Optional(Type.Object({
+        event: Type.String(),
+        /** Empty or absent for a group without a matcher, which matches everything. */
+        matcher: Type.Optional(Type.String()),
+        definition: Type.Unknown(),
+    })),
+});
+/** One subagent file change: a new agent, a changed one, or one deleted. */
+export const AgentEditBody = Type.Object({
+    dir: Type.String(),
+    /** An agent the scan shows here; absent when creating one. */
+    path: Type.Optional(Type.String()),
+    /** Where a new agent goes, and its file name without .md. */
+    create: Type.Optional(Type.Object({ scope: Type.Enum(["user", "project"]), file: Type.String() })),
+    /** The whole file; null deletes the agent. */
+    text: Type.Union([Type.String(), Type.Null()]),
+});
+/**
+ * One MCP server change. Project servers are changed in .mcp.json; user and local ones through
+ * `claude mcp`. With both, the server is replaced, keeping its place in .mcp.json.
+ */
+export const McpEditBody = Type.Object({
+    dir: Type.String(),
+    scope: Type.Enum(["user", "local", "project"]),
+    /** The server to take out, as the scan showed it; refused when it changed since. */
+    remove: Type.Optional(Type.Object({ name: Type.String(), definition: Type.Unknown() })),
+    add: Type.Optional(Type.Object({ name: Type.String(), definition: Type.Unknown() })),
+});
+/** A save's or restore's revision: the one its preview returned. */
+export const RevisionBody = Type.Object({ revision: Type.String() });
+/** Count which permission rules the transcripts under `path` used. */
+export const UsageBody = Type.Object({ path: Type.String(), rules: Type.Array(Rule) });
+/** Preview a memory change; changing it also sends the revision. */
+export const MemoryBody = Type.Object({ action: Type.String(), path: Type.String() });
+export const OpenBody = Type.Object({ path: Type.String() });
+/** Preview restoring a backup; restoring it also sends the revision. */
+export const BackupBody = Type.Object({ id: Type.String() });

package/dist/shared/scopes.d.ts

@@ -0,0 +1,10 @@
+import { type PermissionList, type Scope } from "./types.ts";
+export declare const EVERY_FILE: Scope[];
+/** Settings files by precedence: managed beats local beats project beats user. */
+export declare const HIGHEST_FIRST: Scope[];
+/** The settings files ccdesk writes to; managed settings belong to your organisation. */
+export declare const EDITABLE_SCOPES: Scope[];
+/** The permission lists, in the order ccdesk shows them. */
+export declare const PERMISSION_LISTS: PermissionList[];
+export declare function allowedScopes(key: string): Scope[];
+export declare function ignoredReason(key: string): string;