@workflow-cannon/workspace-kit 0.2.0 → 0.4.0

package/dist/modules/task-engine/types.d.ts

@@ -0,0 +1,82 @@
+export type TaskStatus = "proposed" | "ready" | "in_progress" | "blocked" | "completed" | "cancelled";
+export type TaskPriority = "P1" | "P2" | "P3";
+export type TaskEntity = {
+    id: string;
+    status: TaskStatus;
+    type: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    priority?: TaskPriority;
+    dependsOn?: string[];
+    unblocks?: string[];
+    phase?: string;
+    metadata?: Record<string, unknown>;
+    ownership?: string;
+    approach?: string;
+    technicalScope?: string[];
+    acceptanceCriteria?: string[];
+};
+export type GuardResult = {
+    allowed: boolean;
+    guardName: string;
+    code?: string;
+    message?: string;
+};
+export type TransitionContext = {
+    allTasks: TaskEntity[];
+    timestamp: string;
+    actor?: string;
+};
+export type TransitionGuard = {
+    name: string;
+    canTransition: (task: TaskEntity, targetState: TaskStatus, context: TransitionContext) => GuardResult;
+};
+export type TransitionEvidence = {
+    transitionId: string;
+    taskId: string;
+    fromState: TaskStatus;
+    toState: TaskStatus;
+    action: string;
+    guardResults: GuardResult[];
+    dependentsUnblocked: string[];
+    timestamp: string;
+    actor?: string;
+};
+export type TaskStoreDocument = {
+    schemaVersion: 1;
+    tasks: TaskEntity[];
+    transitionLog: TransitionEvidence[];
+    lastUpdated: string;
+};
+export type TaskEngineError = {
+    code: TaskEngineErrorCode;
+    message: string;
+};
+export type TaskEngineErrorCode = "invalid-transition" | "guard-rejected" | "dependency-unsatisfied" | "task-not-found" | "duplicate-task-id" | "invalid-task-schema" | "storage-read-error" | "storage-write-error" | "invalid-adapter" | "import-parse-error";
+export type TaskAdapter = {
+    name: string;
+    supports: () => TaskAdapterCapability[];
+    load: () => Promise<TaskEntity[]>;
+    save?: (tasks: TaskEntity[]) => Promise<void>;
+};
+export type TaskAdapterCapability = "read" | "write" | "watch";
+export type NextActionSuggestion = {
+    readyQueue: TaskEntity[];
+    suggestedNext: TaskEntity | null;
+    stateSummary: {
+        proposed: number;
+        ready: number;
+        in_progress: number;
+        blocked: number;
+        completed: number;
+        cancelled: number;
+        total: number;
+    };
+    blockingAnalysis: BlockingAnalysisEntry[];
+};
+export type BlockingAnalysisEntry = {
+    taskId: string;
+    blockedBy: string[];
+    blockingCount: number;
+};

package/dist/modules/task-engine/types.js

@@ -0,0 +1 @@
+export {};

package/dist/modules/workspace-config/index.d.ts

@@ -0,0 +1,2 @@
+import type { WorkflowModule } from "../../contracts/module-contract.js";
+export declare const workspaceConfigModule: WorkflowModule;

package/dist/modules/workspace-config/index.js

@@ -0,0 +1,72 @@
+import { explainConfigPath, resolveWorkspaceConfigWithLayers } from "../../core/workspace-kit-config.js";
+async function handleExplainConfig(args, ctx) {
+    const pathArg = typeof args.path === "string" ? args.path.trim() : "";
+    if (!pathArg) {
+        return {
+            ok: false,
+            code: "invalid-config-path",
+            message: "explain-config requires string 'path' (dot-separated, e.g. tasks.storeRelativePath)"
+        };
+    }
+    const invocationConfig = typeof args.config === "object" && args.config !== null && !Array.isArray(args.config)
+        ? args.config
+        : {};
+    const { layers } = await resolveWorkspaceConfigWithLayers({
+        workspacePath: ctx.workspacePath,
+        registry: ctx.registry,
+        invocationConfig
+    });
+    const explained = explainConfigPath(pathArg, layers);
+    return {
+        ok: true,
+        code: "config-explained",
+        data: explained
+    };
+}
+export const workspaceConfigModule = {
+    registration: {
+        id: "workspace-config",
+        version: "0.4.0",
+        contractVersion: "1",
+        capabilities: ["diagnostics"],
+        dependsOn: [],
+        enabledByDefault: true,
+        config: {
+            path: "src/modules/workspace-config/config.md",
+            format: "md",
+            description: "Workspace config registry and explain surface."
+        },
+        state: {
+            path: "src/modules/workspace-config/state.md",
+            format: "md",
+            description: "Workspace config module runtime state (none)."
+        },
+        instructions: {
+            directory: "src/modules/workspace-config/instructions",
+            entries: [
+                {
+                    name: "explain-config",
+                    file: "explain-config.md",
+                    description: "Agent-first JSON: effective config value and winning layer for a dotted path."
+                }
+            ]
+        }
+    },
+    async onCommand(command, ctx) {
+        if (command.name !== "explain-config") {
+            return { ok: false, code: "unknown-command", message: "workspace-config only implements explain-config" };
+        }
+        const reg = ctx.moduleRegistry;
+        if (!reg) {
+            return {
+                ok: false,
+                code: "internal-error",
+                message: "explain-config requires moduleRegistry on context (CLI wiring)"
+            };
+        }
+        return handleExplainConfig(command.args ?? {}, {
+            workspacePath: ctx.workspacePath,
+            registry: reg
+        });
+    }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workflow-cannon/workspace-kit",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "private": false,
   "packageManager": "pnpm@10.0.0",
   "license": "MIT",