@jakkrichm/create-nexus-devflow 2.8.0 → 2.9.3

package/dist/lib/run-state.js

@@ -0,0 +1,203 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const RUN_STATE_PATH = path.join("devflow", ".state", "run.json");
+const COMMAND_PATTERN = /^[a-z][a-z-]{0,31}$/;
+const RUN_STATUSES = new Set([
+    "running",
+    "blocked",
+    "ready",
+    "completed"
+]);
+const RUN_BOUNDARIES = new Set([
+    "read-only",
+    "reviewed",
+    "local-only"
+]);
+const RUN_STALE_AFTER_MS = 60 * 60 * 1000;
+async function readRunState(projectRoot, now = new Date()) {
+    const runStatePath = path.join(projectRoot, RUN_STATE_PATH);
+    try {
+        const stats = await fs.lstat(runStatePath);
+        if (stats.isSymbolicLink()) {
+            return malformedSummary({
+                code: "unsafe_run_state_path",
+                message: "Dashboard run state is a symbolic link and was not read."
+            });
+        }
+        if (!stats.isFile()) {
+            return malformedSummary({
+                code: "invalid_run_state_path",
+                message: "Dashboard run state path is not a regular file."
+            });
+        }
+        return parseRunState(await fs.readFile(runStatePath, "utf8"), now);
+    }
+    catch (error) {
+        if (getErrorCode(error) === "ENOENT") {
+            return idleSummary();
+        }
+        throw error;
+    }
+}
+function parseRunState(value, now = new Date()) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        return malformedSummary({
+            code: "malformed_run_state",
+            message: "Dashboard run state is not valid JSON."
+        });
+    }
+    if (!isRecord(parsed)) {
+        return malformedRunState();
+    }
+    const command = readString(parsed.command);
+    const status = readString(parsed.status);
+    const summary = readString(parsed.summary);
+    const detail = readOptionalString(parsed.detail);
+    const boundary = readOptionalString(parsed.boundary);
+    const startedAt = readString(parsed.startedAt);
+    const updatedAt = readString(parsed.updatedAt);
+    const resumeCommand = readOptionalString(parsed.resumeCommand);
+    const progress = parseProgress(parsed.progress);
+    const feature = parseFeature(parsed.feature);
+    if (parsed.schemaVersion !== 1 ||
+        !command ||
+        !COMMAND_PATTERN.test(command) ||
+        !status ||
+        !RUN_STATUSES.has(status) ||
+        !summary ||
+        !startedAt ||
+        !updatedAt ||
+        !isTimestamp(startedAt) ||
+        !isTimestamp(updatedAt) ||
+        Date.parse(startedAt) > Date.parse(updatedAt) ||
+        (parsed.detail !== undefined && detail === null) ||
+        (parsed.boundary !== undefined && (!boundary || !RUN_BOUNDARIES.has(boundary))) ||
+        (parsed.resumeCommand !== undefined && resumeCommand === null) ||
+        (parsed.progress !== undefined && progress === null) ||
+        (parsed.feature !== undefined && feature === null)) {
+        return malformedRunState();
+    }
+    const freshness = status === "running" &&
+        now.getTime() - Date.parse(updatedAt) > RUN_STALE_AFTER_MS
+        ? "stale"
+        : "current";
+    const warnings = freshness === "stale"
+        ? [
+            {
+                code: "stale_run_state",
+                message: `Recorded /${command} activity has not updated for over one hour and may have been interrupted.`
+            }
+        ]
+        : [];
+    return {
+        state: "recorded",
+        mode: command === "autopilot"
+            ? "autopilot"
+            : command === "continuous"
+                ? "continuous"
+                : "manual",
+        command,
+        status,
+        freshness,
+        summary,
+        detail,
+        boundary,
+        startedAt,
+        updatedAt,
+        resumeCommand,
+        progress,
+        feature,
+        warnings
+    };
+}
+function parseProgress(value) {
+    if (value === undefined) {
+        return null;
+    }
+    if (!isRecord(value)) {
+        return null;
+    }
+    const label = readString(value.label);
+    const current = value.current;
+    const total = value.total;
+    if (!label ||
+        !Number.isInteger(current) ||
+        !Number.isInteger(total) ||
+        Number(current) < 0 ||
+        Number(total) < 1 ||
+        Number(current) > Number(total)) {
+        return null;
+    }
+    return { label, current: Number(current), total: Number(total) };
+}
+function parseFeature(value) {
+    if (value === undefined) {
+        return null;
+    }
+    if (!isRecord(value)) {
+        return null;
+    }
+    const id = readOptionalString(value.id);
+    const title = readString(value.title);
+    if (!title || (value.id !== undefined && id === null)) {
+        return null;
+    }
+    return { id, title };
+}
+function malformedRunState() {
+    return malformedSummary({
+        code: "malformed_run_state",
+        message: "Dashboard run state does not match schema version 1."
+    });
+}
+function idleSummary() {
+    return {
+        state: "idle",
+        mode: "manual",
+        command: null,
+        status: null,
+        freshness: null,
+        summary: null,
+        detail: null,
+        boundary: null,
+        startedAt: null,
+        updatedAt: null,
+        resumeCommand: null,
+        progress: null,
+        feature: null,
+        warnings: []
+    };
+}
+function malformedSummary(warning) {
+    return {
+        ...idleSummary(),
+        state: "malformed",
+        warnings: [warning]
+    };
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}
+function readOptionalString(value) {
+    return value === undefined ? null : readString(value);
+}
+function isTimestamp(value) {
+    return !Number.isNaN(Date.parse(value));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getErrorCode(error) {
+    return typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+export { RUN_STATE_PATH, parseRunState, readRunState };
+//# sourceMappingURL=run-state.js.map

package/dist/lib/run-state.js.map

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

package/dist/lib/skill-manager.d.ts

@@ -0,0 +1,73 @@
+export interface InstalledSkillRecord {
+    name: string;
+    source: string;
+    version?: string;
+    description?: string;
+    installedAt: string;
+    type?: "git" | "local" | "npm";
+}
+export interface SkillDetail {
+    name: string;
+    category: "core" | "third-party" | "local-extension";
+    description: string;
+    version?: string;
+    source?: string;
+    adapters: string[];
+    synced: boolean;
+    path: string;
+}
+export interface SkillListResult {
+    coreSkills: SkillDetail[];
+    thirdPartySkills: SkillDetail[];
+    totalCount: number;
+}
+export interface InstallSkillOptions {
+    name?: string;
+    all?: boolean;
+    force?: boolean;
+    overrideSource?: string;
+}
+export declare function parseSkillFrontmatter(content: string): {
+    name?: string;
+    description?: string;
+    version?: string;
+};
+export declare function readDevflowManifest(projectRoot: string): Promise<Record<string, unknown> | null>;
+export declare function writeDevflowManifest(projectRoot: string, manifest: Record<string, unknown>): Promise<void>;
+export declare function listInstalledSkills(projectRoot: string): Promise<SkillListResult>;
+export interface DiscoveredSkill {
+    sourceSkillPath: string;
+    skillName: string;
+    meta: {
+        name?: string;
+        description?: string;
+        version?: string;
+    };
+}
+export declare function discoverSkillsInDirectory(rootDir: string, maxDepth?: number, currentDepth?: number): Promise<DiscoveredSkill[]>;
+export declare function findSkillSourceDirectory(sourceDir: string, requestedName?: string): Promise<{
+    sourceSkillPath: string;
+    skillName: string;
+    meta: {
+        name?: string;
+        description?: string;
+        version?: string;
+    };
+}>;
+export declare function installThirdPartySkill(projectRoot: string, source: string, options?: InstallSkillOptions): Promise<SkillDetail | SkillDetail[]>;
+export declare function removeThirdPartySkill(projectRoot: string, name: string): Promise<boolean>;
+export declare function syncSkills(projectRoot: string): Promise<{
+    syncedCount: number;
+    skills: string[];
+}>;
+export interface SkillUpdateResult {
+    updatedSkills: SkillDetail[];
+    failedSkills: Array<{
+        name: string;
+        reason: string;
+    }>;
+    totalUpdated: number;
+}
+export declare function updateThirdPartySkills(projectRoot: string, targetSkillName?: string, options?: {
+    force?: boolean;
+}): Promise<SkillUpdateResult>;