skills-console 0.4.0

package/dist/domain/operations.d.ts

@@ -0,0 +1,50 @@
+import type { OperationKind, SkillsCommandPlan } from '../adapters/skills-cli/types.js';
+import type { LinkKind, Scope } from './types.js';
+export interface BackupEntry {
+    id: string;
+    skillName: string;
+    originalPath: string;
+    realPath: string;
+    backupRelativePath: string;
+    linkKind: LinkKind;
+    linkTarget: string | undefined;
+    scope: Scope;
+}
+export interface OperationSnapshot {
+    schemaVersion: 1;
+    id: string;
+    operationKind: Exclude<OperationKind, 'preview'>;
+    createdAt: string;
+    restoredAt: string | undefined;
+    directory: string;
+    allowedRoots: string[];
+    entries: BackupEntry[];
+    createdPaths: string[];
+}
+export type OperationRecordStatus = 'running' | 'succeeded' | 'failed' | 'restored';
+export interface OperationRecord {
+    schemaVersion: 1;
+    id: string;
+    kind: Exclude<OperationKind, 'preview'>;
+    status: OperationRecordStatus;
+    startedAt: string;
+    finishedAt: string | undefined;
+    command: string;
+    cwd: string;
+    skillNames: string[];
+    agentIds: string[];
+    scope: Scope | undefined;
+    snapshotId: string;
+    exitCode: number | undefined;
+    verificationStatus: 'verified' | 'failed' | 'indeterminate' | undefined;
+    verificationMessages: string[];
+    logs: string[];
+    error: string | undefined;
+}
+export interface RestoreResult {
+    snapshotId: string;
+    restoredEntries: number;
+    removedCreatedPaths: number;
+    fallbacks: string[];
+}
+export declare function operationRecordFromPlan(id: string, snapshotId: string, plan: SkillsCommandPlan): OperationRecord;

package/dist/domain/operations.js

@@ -0,0 +1,25 @@
+export function operationRecordFromPlan(id, snapshotId, plan) {
+    if (plan.kind === 'preview') {
+        throw new Error('Preview commands cannot create operation records.');
+    }
+    return {
+        schemaVersion: 1,
+        id,
+        kind: plan.kind,
+        status: 'running',
+        startedAt: new Date().toISOString(),
+        finishedAt: undefined,
+        command: plan.displayCommand,
+        cwd: plan.cwd,
+        skillNames: plan.skillNames,
+        agentIds: plan.agentIds,
+        scope: plan.scope,
+        snapshotId,
+        exitCode: undefined,
+        verificationStatus: undefined,
+        verificationMessages: [],
+        logs: [],
+        error: undefined,
+    };
+}
+//# sourceMappingURL=operations.js.map

package/dist/domain/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/domain/operations.ts"],"names":[],"mappings":"AAuDA,MAAM,UAAU,uBAAuB,CACrC,EAAU,EACV,UAAkB,EAClB,IAAuB;IAEvB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,EAAE;QACF,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,IAAI,CAAC,cAAc;QAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU;QACV,QAAQ,EAAE,SAAS;QACnB,kBAAkB,EAAE,SAAS;QAC7B,oBAAoB,EAAE,EAAE;QACxB,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC"}

package/dist/domain/profile.d.ts

@@ -0,0 +1,43 @@
+import type { Scope, SkillInstallation } from './types.js';
+export interface ProfilePolicy {
+    removeExtras: boolean;
+    manageUserScope: boolean;
+}
+export interface ProfileSkill {
+    name: string;
+    source?: string;
+    agentIds: string[];
+    scope: Scope;
+    mode: 'symlink' | 'copy';
+}
+export interface SkillsProfile {
+    schemaVersion: 1;
+    name: string;
+    description?: string;
+    policy: ProfilePolicy;
+    skills: ProfileSkill[];
+}
+export type ProfileDiffStatus = 'satisfied' | 'missing' | 'source-mismatch' | 'source-unknown' | 'extra';
+export interface ProfileDiffEntry {
+    id: string;
+    status: ProfileDiffStatus;
+    skillName: string;
+    scope: Scope;
+    expected?: ProfileSkill;
+    actual: SkillInstallation[];
+    missingAgentIds: string[];
+    message: string;
+}
+export interface ProfileDiffSummary {
+    satisfied: number;
+    missing: number;
+    sourceMismatch: number;
+    sourceUnknown: number;
+    extra: number;
+}
+export interface ProfileDiff {
+    profile: SkillsProfile;
+    entries: ProfileDiffEntry[];
+    summary: ProfileDiffSummary;
+    hasChanges: boolean;
+}

package/dist/domain/profile.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=profile.js.map

package/dist/domain/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/domain/profile.ts"],"names":[],"mappings":""}

package/dist/domain/types.d.ts

@@ -0,0 +1,98 @@
+export type Scope = 'user' | 'project';
+export type RootKind = 'agent' | 'shared' | 'system' | 'plugin-cache';
+export type LinkKind = 'directory' | 'symlink';
+export type Severity = 'error' | 'warning' | 'info';
+export interface EnvironmentInfo {
+    cwd: string;
+    projectRoot: string;
+    homeDir: string;
+    platform: NodeJS.Platform;
+    release: string;
+    isWsl: boolean;
+    nodeVersion: string;
+    npxAvailable: boolean;
+}
+export interface SkillRoot {
+    id: string;
+    path: string;
+    scope: Scope;
+    kind: RootKind;
+    agentIds: string[];
+    exists: boolean;
+    readable: boolean;
+    writable: boolean;
+    mutable: boolean;
+    maxDepth: number;
+    excludedDirectoryNames: string[];
+}
+export interface AgentHost {
+    id: string;
+    displayName: string;
+    detected: boolean;
+    detectionReasons: string[];
+    roots: SkillRoot[];
+}
+export interface Diagnostic {
+    id: string;
+    code: string;
+    severity: Severity;
+    message: string;
+    path: string | undefined;
+    skillName: string | undefined;
+}
+export interface SkillManifest {
+    name: string | undefined;
+    description: string | undefined;
+    license: string | undefined;
+    compatibility: string | undefined;
+    allowedTools: string | undefined;
+    metadata: Record<string, unknown>;
+    source: string | undefined;
+    valid: boolean;
+    errors: string[];
+}
+export interface SkillInstallation {
+    id: string;
+    skillName: string;
+    directoryName: string;
+    description: string;
+    manifestPath: string;
+    path: string;
+    realPath: string;
+    scope: Scope;
+    rootKind: RootKind;
+    agentIds: string[];
+    linkKind: LinkKind;
+    mutable: boolean;
+    source: string | undefined;
+    modifiedAtMs: number;
+    isEffective: boolean;
+    diagnostics: Diagnostic[];
+}
+export interface SkillGroup {
+    name: string;
+    description: string;
+    installations: SkillInstallation[];
+    agentIds: string[];
+    scopes: Scope[];
+    errorCount: number;
+    warningCount: number;
+}
+export interface InventoryStats {
+    skillCount: number;
+    installationCount: number;
+    detectedAgentCount: number;
+    scannedRootCount: number;
+    errorCount: number;
+    warningCount: number;
+}
+export interface Inventory {
+    environment: EnvironmentInfo;
+    agents: AgentHost[];
+    roots: SkillRoot[];
+    installations: SkillInstallation[];
+    skills: SkillGroup[];
+    diagnostics: Diagnostic[];
+    stats: InventoryStats;
+    scannedAt: string;
+}

package/dist/domain/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/domain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/domain/types.ts"],"names":[],"mappings":""}

package/dist/platform/data-paths.d.ts

@@ -0,0 +1,3 @@
+export declare function resolveDataRoot(homeDir: string, override?: string): string;
+export declare function historyDirectory(dataRoot: string): string;
+export declare function backupsDirectory(dataRoot: string): string;

package/dist/platform/data-paths.js

@@ -0,0 +1,17 @@
+import { join, resolve } from 'node:path';
+export function resolveDataRoot(homeDir, override) {
+    if (override) {
+        return resolve(override);
+    }
+    const xdgDataHome = process.env.XDG_DATA_HOME;
+    return xdgDataHome
+        ? resolve(xdgDataHome, 'skills-console')
+        : resolve(homeDir, '.local', 'share', 'skills-console');
+}
+export function historyDirectory(dataRoot) {
+    return join(dataRoot, 'history');
+}
+export function backupsDirectory(dataRoot) {
+    return join(dataRoot, 'backups');
+}
+//# sourceMappingURL=data-paths.js.map

package/dist/platform/data-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-paths.js","sourceRoot":"","sources":["../../src/platform/data-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,QAAiB;IAChE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC9C,OAAO,WAAW;QAChB,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,gBAAgB,CAAC;QACxC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC"}

package/dist/platform/environment.d.ts

@@ -0,0 +1,6 @@
+import type { EnvironmentInfo } from '../domain/types.js';
+export declare function executableExists(executable: string, pathValue?: string): Promise<boolean>;
+export declare function detectEnvironment(options?: {
+    cwd?: string;
+    homeDir?: string;
+}): Promise<EnvironmentInfo>;

package/dist/platform/environment.js

@@ -0,0 +1,71 @@
+import { access, readFile, stat } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { delimiter, dirname, join, parse, resolve } from 'node:path';
+import { homedir, platform, release } from 'node:os';
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findProjectRoot(cwd) {
+    let cursor = resolve(cwd);
+    const filesystemRoot = parse(cursor).root;
+    while (true) {
+        if (await pathExists(join(cursor, '.git'))) {
+            return cursor;
+        }
+        if (cursor === filesystemRoot) {
+            return resolve(cwd);
+        }
+        cursor = dirname(cursor);
+    }
+}
+async function detectWsl(currentPlatform) {
+    if (currentPlatform !== 'linux') {
+        return false;
+    }
+    if (process.env.WSL_DISTRO_NAME || process.env.WSL_INTEROP) {
+        return true;
+    }
+    try {
+        const version = await readFile('/proc/version', 'utf8');
+        return /microsoft|wsl/i.test(version);
+    }
+    catch {
+        return false;
+    }
+}
+export async function executableExists(executable, pathValue = process.env.PATH ?? '') {
+    const extensions = platform() === 'win32' ? ['', '.exe', '.cmd', '.bat'] : [''];
+    for (const segment of pathValue.split(delimiter).filter(Boolean)) {
+        for (const extension of extensions) {
+            try {
+                await access(join(segment, `${executable}${extension}`), constants.X_OK);
+                return true;
+            }
+            catch {
+                // Continue searching the remaining PATH entries.
+            }
+        }
+    }
+    return false;
+}
+export async function detectEnvironment(options = {}) {
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const currentPlatform = platform();
+    return {
+        cwd,
+        projectRoot: await findProjectRoot(cwd),
+        homeDir: resolve(options.homeDir ?? homedir()),
+        platform: currentPlatform,
+        release: release(),
+        isWsl: await detectWsl(currentPlatform),
+        nodeVersion: process.version,
+        npxAvailable: await executableExists('npx'),
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/platform/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/platform/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAC,SAAS,EAAC,MAAM,SAAS,CAAC;AAClC,OAAO,EAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AACnE,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAC,MAAM,SAAS,CAAC;AAInD,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,GAAW;IACxC,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IAE1C,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAED,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,eAAgC;IACvD,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;IAElC,MAAM,UAAU,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhF,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACjE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBACzE,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAO,GAG3C,EAAE;IACJ,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,QAAQ,EAAE,CAAC;IAEnC,OAAO;QACL,GAAG;QACH,WAAW,EAAE,MAAM,eAAe,CAAC,GAAG,CAAC;QACvC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9C,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,OAAO,EAAE;QAClB,KAAK,EAAE,MAAM,SAAS,CAAC,eAAe,CAAC;QACvC,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,YAAY,EAAE,MAAM,gBAAgB,CAAC,KAAK,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/platform/redaction.d.ts

@@ -0,0 +1 @@
+export declare function redactSensitiveText(value: string): string;

package/dist/platform/redaction.js

@@ -0,0 +1,7 @@
+export function redactSensitiveText(value) {
+    return value
+        .replace(/(https?:\/\/)([^/@\s]+)@/gi, '$1***@')
+        .replace(/([?&](?:token|access_token|auth|key)=)[^&\s]+/gi, '$1***')
+        .replace(/(ghp_|github_pat_|glpat-)[a-zA-Z0-9_-]+/g, '$1***');
+}
+//# sourceMappingURL=redaction.js.map

package/dist/platform/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/platform/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK;SACT,OAAO,CAAC,4BAA4B,EAAE,QAAQ,CAAC;SAC/C,OAAO,CAAC,iDAAiD,EAAE,OAAO,CAAC;SACnE,OAAO,CAAC,0CAA0C,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/ui/App.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare function App(): React.JSX.Element;