@workflow-cannon/workspace-kit 0.17.0 → 0.24.0

package/dist/core/state/unified-state-db.js

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import path from "node:path";
+import Database from "better-sqlite3";
+const DDL = `
+CREATE TABLE IF NOT EXISTS workspace_module_state (
+  module_id TEXT PRIMARY KEY,
+  state_schema_version INTEGER NOT NULL,
+  state_json TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+`;
+export class UnifiedStateDb {
+    db = null;
+    dbPath;
+    exportSnapshotPath;
+    constructor(workspacePath, databaseRelativePath, options) {
+        this.dbPath = path.resolve(workspacePath, databaseRelativePath);
+        this.exportSnapshotPath = options?.exportSnapshotRelativePath
+            ? path.resolve(workspacePath, options.exportSnapshotRelativePath)
+            : null;
+    }
+    ensureDb() {
+        if (this.db)
+            return this.db;
+        fs.mkdirSync(path.dirname(this.dbPath), { recursive: true });
+        this.db = new Database(this.dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.exec(DDL);
+        return this.db;
+    }
+    getModuleState(moduleId) {
+        const db = this.ensureDb();
+        const row = db
+            .prepare("SELECT module_id, state_schema_version, state_json, updated_at FROM workspace_module_state WHERE module_id = ?")
+            .get(moduleId);
+        if (!row)
+            return null;
+        return {
+            moduleId: row.module_id,
+            stateSchemaVersion: row.state_schema_version,
+            state: JSON.parse(row.state_json),
+            updatedAt: row.updated_at
+        };
+    }
+    setModuleState(moduleId, stateSchemaVersion, state) {
+        const db = this.ensureDb();
+        const updatedAt = new Date().toISOString();
+        db.prepare(`INSERT INTO workspace_module_state (module_id, state_schema_version, state_json, updated_at)
+       VALUES (?, ?, ?, ?)
+       ON CONFLICT(module_id) DO UPDATE SET
+         state_schema_version=excluded.state_schema_version,
+         state_json=excluded.state_json,
+         updated_at=excluded.updated_at`).run(moduleId, stateSchemaVersion, JSON.stringify(state), updatedAt);
+        this.maybeExportSnapshot();
+    }
+    listModuleStates() {
+        const db = this.ensureDb();
+        const rows = db
+            .prepare("SELECT module_id, state_schema_version, state_json, updated_at FROM workspace_module_state ORDER BY module_id ASC")
+            .all();
+        return rows.map((row) => ({
+            moduleId: row.module_id,
+            stateSchemaVersion: row.state_schema_version,
+            state: JSON.parse(row.state_json),
+            updatedAt: row.updated_at
+        }));
+    }
+    maybeExportSnapshot() {
+        if (!this.exportSnapshotPath)
+            return;
+        const snapshot = {
+            schemaVersion: 1,
+            exportedAt: new Date().toISOString(),
+            dbPath: this.dbPath,
+            modules: this.listModuleStates()
+        };
+        fs.mkdirSync(path.dirname(this.exportSnapshotPath), { recursive: true });
+        fs.writeFileSync(this.exportSnapshotPath, JSON.stringify(snapshot, null, 2) + "\n", "utf8");
+    }
+}

package/dist/core/workspace-kit-config.js

@@ -10,6 +10,14 @@ export function getProjectConfigPath(workspacePath) {
 /** Built-in defaults (lowest layer). */
 export const KIT_CONFIG_DEFAULTS = {
     core: {},
+    /**
+     * Module enablement: `enabled` whitelist (non-empty replaces default-by-flag set), then `disabled` subtracts.
+     * Empty arrays = no effect (all modules use registration.enabledByDefault).
+     */
+    modules: {
+        enabled: [],
+        disabled: []
+    },
     tasks: {
         storeRelativePath: ".workspace-kit/tasks/state.json",
         strictValidation: false
@@ -46,7 +54,11 @@ export const KIT_CONFIG_DEFAULTS = {
  */
 export const MODULE_CONFIG_CONTRIBUTIONS = {
     approvals: {},
-    planning: {}
+    planning: {
+        defaultQuestionDepth: "adaptive",
+        hardBlockCriticalUnknowns: true,
+        rulePacks: {}
+    }
 };
 export function deepMerge(target, source) {
     const out = { ...target };

package/dist/modules/agent-behavior/builtins.d.ts

@@ -0,0 +1,3 @@
+import { type BehaviorProfile } from "./types.js";
+export declare const DEFAULT_BUILTIN_PROFILE_ID = "builtin:balanced";
+export declare const BUILTIN_PROFILES: Record<string, BehaviorProfile>;

package/dist/modules/agent-behavior/builtins.js

@@ -0,0 +1,71 @@
+import { BEHAVIOR_PROFILE_SCHEMA_VERSION } from "./types.js";
+export const DEFAULT_BUILTIN_PROFILE_ID = "builtin:balanced";
+const nowMeta = () => ({
+    source: "builtin",
+    createdAt: new Date().toISOString()
+});
+export const BUILTIN_PROFILES = {
+    "builtin:cautious": {
+        schemaVersion: BEHAVIOR_PROFILE_SCHEMA_VERSION,
+        id: "builtin:cautious",
+        label: "Cautious",
+        summary: "Prefer small steps, frequent check-ins, and explicit confirmation before larger edits.",
+        dimensions: {
+            deliberationDepth: "high",
+            changeAppetite: "conservative",
+            checkInFrequency: "often",
+            explanationVerbosity: "verbose",
+            explorationStyle: "linear",
+            ambiguityHandling: "ask"
+        },
+        interactionNotes: "Surface risks early; default to the smallest reversible change.",
+        metadata: nowMeta()
+    },
+    "builtin:balanced": {
+        schemaVersion: BEHAVIOR_PROFILE_SCHEMA_VERSION,
+        id: "builtin:balanced",
+        label: "Balanced",
+        summary: "Default collaboration: clear reasoning, normal autonomy when intent is clear.",
+        dimensions: {
+            deliberationDepth: "medium",
+            changeAppetite: "balanced",
+            checkInFrequency: "normal",
+            explanationVerbosity: "normal",
+            explorationStyle: "linear",
+            ambiguityHandling: "ask"
+        },
+        metadata: nowMeta()
+    },
+    "builtin:calculated": {
+        schemaVersion: BEHAVIOR_PROFILE_SCHEMA_VERSION,
+        id: "builtin:calculated",
+        label: "Calculated",
+        summary: "Structured analysis and explicit tradeoffs before acting; still respects governance.",
+        dimensions: {
+            deliberationDepth: "high",
+            changeAppetite: "balanced",
+            checkInFrequency: "normal",
+            explanationVerbosity: "verbose",
+            explorationStyle: "linear",
+            ambiguityHandling: "ask"
+        },
+        interactionNotes: "Lay out options with pros/cons; prefer evidence-backed recommendations.",
+        metadata: nowMeta()
+    },
+    "builtin:experimental": {
+        schemaVersion: BEHAVIOR_PROFILE_SCHEMA_VERSION,
+        id: "builtin:experimental",
+        label: "Experimental",
+        summary: "Try alternatives and parallel approaches in low-risk areas; still obey policy gates.",
+        dimensions: {
+            deliberationDepth: "medium",
+            changeAppetite: "bold",
+            checkInFrequency: "normal",
+            explanationVerbosity: "normal",
+            explorationStyle: "parallel",
+            ambiguityHandling: "decide"
+        },
+        interactionNotes: "Experimental does not mean skipping tests, approvals, or PRINCIPLES—only style of exploration.",
+        metadata: nowMeta()
+    }
+};

package/dist/modules/agent-behavior/explain.d.ts

@@ -0,0 +1,6 @@
+import type { BehaviorProfile } from "./types.js";
+export declare function summarizeProfileMarkdown(profile: BehaviorProfile): string;
+export declare function diffProfiles(a: BehaviorProfile, b: BehaviorProfile): Record<string, {
+    from: string;
+    to: string;
+}>;

package/dist/modules/agent-behavior/explain.js

@@ -0,0 +1,46 @@
+function dimLine(label, v) {
+    return `- **${label}:** ${v}`;
+}
+const LABELS = {
+    changeAppetite: "Change appetite",
+    deliberationDepth: "Deliberation depth",
+    explanationVerbosity: "Explanation verbosity",
+    explorationStyle: "Exploration style",
+    ambiguityHandling: "Ambiguity handling",
+    checkInFrequency: "Check-in frequency"
+};
+export function summarizeProfileMarkdown(profile) {
+    const lines = [
+        `## ${profile.label} (\`${profile.id}\`)`,
+        "",
+        profile.summary,
+        "",
+        "### Dimensions",
+        dimLine(LABELS.changeAppetite, profile.dimensions.changeAppetite),
+        dimLine(LABELS.deliberationDepth, profile.dimensions.deliberationDepth),
+        dimLine(LABELS.explanationVerbosity, profile.dimensions.explanationVerbosity),
+        dimLine(LABELS.explorationStyle, profile.dimensions.explorationStyle),
+        dimLine(LABELS.ambiguityHandling, profile.dimensions.ambiguityHandling),
+        dimLine(LABELS.checkInFrequency, profile.dimensions.checkInFrequency)
+    ];
+    if (profile.interactionNotes) {
+        lines.push("", "### Interaction notes", "", profile.interactionNotes);
+    }
+    return lines.join("\n");
+}
+export function diffProfiles(a, b) {
+    const diff = {};
+    const keys = Object.keys(a.dimensions);
+    for (const k of keys) {
+        if (a.dimensions[k] !== b.dimensions[k]) {
+            diff[k] = { from: a.dimensions[k], to: b.dimensions[k] };
+        }
+    }
+    if (a.label !== b.label) {
+        diff.label = { from: a.label, to: b.label };
+    }
+    if (a.summary !== b.summary) {
+        diff.summary = { from: a.summary, to: b.summary };
+    }
+    return diff;
+}

package/dist/modules/agent-behavior/index.d.ts

@@ -0,0 +1,4 @@
+export { BUILTIN_PROFILES, DEFAULT_BUILTIN_PROFILE_ID } from "./builtins.js";
+export { validateBehaviorProfile, mergeDimensions } from "./validate.js";
+import type { WorkflowModule } from "../../contracts/module-contract.js";
+export declare const agentBehaviorModule: WorkflowModule;