@aipper/aiws 0.0.29 → 0.0.30

package/dist/opencode-env.js

@@ -0,0 +1,178 @@
+import path from "node:path";
+import { pathExists, readText } from "./fs.js";
+const OPENCODE_AGENT_NAMES = ["planner-sisyphus", "librarian", "explore", "oracle"];
+const SAFE_READ_ONLY_COMMANDS = new Set(["rg", "cat", "sed", "ls", "find", "git status", "git diff"]);
+const REQUIRED_WRITE_ALLOW_PATHS = [".aiws/tmp/", ".aiws/changes/*/analysis/", ".aiws/changes/*/review/", ".aiws/changes/*/evidence/"];
+const REQUIRED_DENY_PATHS = [".aiws/secrets/", ".env*"];
+const REQUIRED_DENY_COMMANDS = ["rm", "mv", "git commit", "git push", "npm publish"];
+function relativeOrDot(value) {
+    return value ? value.replaceAll(path.sep, "/") : ".";
+}
+function readAgentState(raw, agentName) {
+    const agents = raw && typeof raw === "object" && raw.agents && typeof raw.agents === "object" ? raw.agents : {};
+    const entry = agents[agentName];
+    return {
+        present: !!entry && typeof entry === "object",
+        enabled: !!(entry && typeof entry === "object" && entry.enabled === true),
+        replacePlan: entry && typeof entry === "object" && typeof entry.replace_plan === "boolean" ? entry.replace_plan : null,
+        promptAppendConfigured: !!(entry &&
+            typeof entry === "object" &&
+            typeof entry.prompt_append === "string" &&
+            entry.prompt_append.trim().length > 0),
+    };
+}
+function readApprovalWhitelistState(raw) {
+    const policy = raw &&
+        typeof raw === "object" &&
+        raw.aiws &&
+        typeof raw.aiws === "object" &&
+        raw.aiws.autonomy &&
+        typeof raw.aiws.autonomy === "object" &&
+        raw.aiws.autonomy.approval_whitelist &&
+        typeof raw.aiws.autonomy.approval_whitelist === "object"
+        ? raw.aiws.autonomy.approval_whitelist
+        : null;
+    const readOnlyCommands = Array.isArray(policy?.read_only_commands)
+        ? policy.read_only_commands.filter((value) => typeof value === "string" && value.trim().length > 0)
+        : [];
+    const writeAllowPaths = Array.isArray(policy?.write_allow_paths)
+        ? policy.write_allow_paths.filter((value) => typeof value === "string" && value.trim().length > 0)
+        : [];
+    const denyPaths = Array.isArray(policy?.deny_paths)
+        ? policy.deny_paths.filter((value) => typeof value === "string" && value.trim().length > 0)
+        : [];
+    const denyCommands = Array.isArray(policy?.deny_commands)
+        ? policy.deny_commands.filter((value) => typeof value === "string" && value.trim().length > 0)
+        : [];
+    const mode = typeof policy?.mode === "string" && policy.mode.trim().length > 0 ? policy.mode : "";
+    const hostPermissionMode = typeof policy?.host_permission_mode === "string" && policy.host_permission_mode.trim().length > 0
+        ? policy.host_permission_mode
+        : "";
+    const enabled = policy?.enabled === true;
+    const safeReadOnlyCommands = readOnlyCommands.every((value) => SAFE_READ_ONLY_COMMANDS.has(value));
+    const requiredWritePathsPresent = REQUIRED_WRITE_ALLOW_PATHS.every((value) => writeAllowPaths.includes(value));
+    const requiredDenyPathsPresent = REQUIRED_DENY_PATHS.every((value) => denyPaths.includes(value));
+    const requiredDenyCommandsPresent = REQUIRED_DENY_COMMANDS.every((value) => denyCommands.includes(value));
+    const modeValid = mode === "assist-only";
+    return {
+        present: !!policy,
+        enabled,
+        mode,
+        hostPermissionMode,
+        readOnlyCommands,
+        writeAllowPaths,
+        denyPaths,
+        denyCommands,
+        configured: enabled &&
+            modeValid &&
+            safeReadOnlyCommands &&
+            readOnlyCommands.length > 0 &&
+            requiredWritePathsPresent &&
+            requiredDenyPathsPresent &&
+            requiredDenyCommandsPresent &&
+            hostPermissionMode === "manual-only",
+    };
+}
+export async function detectOpenCodeEnvironment(workspaceRoot) {
+    const opencodeDir = path.join(workspaceRoot, ".opencode");
+    const configPath = path.join(opencodeDir, "oh-my-opencode.json");
+    const examplePath = path.join(opencodeDir, "oh-my-opencode.json.example");
+    const opencodeDirExists = await pathExists(opencodeDir);
+    const configExists = await pathExists(configPath);
+    const exampleExists = await pathExists(examplePath);
+    let config = null;
+    let configStatus = "missing";
+    let configError = "";
+    if (configExists) {
+        try {
+            config = JSON.parse(await readText(configPath));
+            configStatus = "loaded";
+        }
+        catch (error) {
+            configStatus = "invalid";
+            configError = error instanceof Error ? error.message : String(error);
+        }
+    }
+    const agents = Object.fromEntries(OPENCODE_AGENT_NAMES.map((name) => [name, readAgentState(config, name)]));
+    const enabledAgents = OPENCODE_AGENT_NAMES.filter((name) => agents[name]?.enabled === true);
+    const recommendedAgentsReady = ["planner-sisyphus", "librarian", "explore", "oracle"].every((name) => agents[name]?.enabled === true);
+    const backgroundTasksConfigured = !!(config && typeof config === "object" && config.backgroundTasks && typeof config.backgroundTasks === "object");
+    const autoResumeEnabled = !!(config &&
+        typeof config === "object" &&
+        config.experimental &&
+        typeof config.experimental === "object" &&
+        config.experimental.auto_resume === true);
+    const approvalWhitelist = readApprovalWhitelistState(config);
+    const claudeSettingsExamplePath = path.join(workspaceRoot, ".claude", "settings.json.example");
+    const approvalWhitelistHelperPath = path.join(opencodeDir, "helpers", "approval-whitelist-check.sh");
+    const approvalWhitelistRunnerPath = path.join(opencodeDir, "helpers", "approval-whitelist-run.sh");
+    const approvalWhitelistWatchdogPath = path.join(opencodeDir, "helpers", "approval-whitelist-watchdog.sh");
+    const tmuxScanHelperPath = path.join(opencodeDir, "helpers", "tmux-swarm-scan.sh");
+    const tmuxRescueHelperPath = path.join(opencodeDir, "helpers", "tmux-swarm-rescue.sh");
+    const claudeSettingsExampleExists = await pathExists(claudeSettingsExamplePath);
+    const approvalWhitelistHelperExists = await pathExists(approvalWhitelistHelperPath);
+    const approvalWhitelistRunnerExists = await pathExists(approvalWhitelistRunnerPath);
+    const approvalWhitelistWatchdogExists = await pathExists(approvalWhitelistWatchdogPath);
+    const tmuxScanHelperExists = await pathExists(tmuxScanHelperPath);
+    const tmuxRescueHelperExists = await pathExists(tmuxRescueHelperPath);
+    const watchdogSuperviseReady = configStatus === "loaded" &&
+        approvalWhitelist.configured &&
+        approvalWhitelistHelperExists &&
+        approvalWhitelistRunnerExists &&
+        approvalWhitelistWatchdogExists;
+    const autonomyReady = configStatus === "loaded" &&
+        agents["planner-sisyphus"]?.promptAppendConfigured === true &&
+        backgroundTasksConfigured &&
+        autoResumeEnabled &&
+        approvalWhitelist.configured &&
+        claudeSettingsExampleExists &&
+        approvalWhitelistHelperExists &&
+        approvalWhitelistRunnerExists &&
+        approvalWhitelistWatchdogExists &&
+        tmuxScanHelperExists &&
+        tmuxRescueHelperExists;
+    return {
+        workspaceRoot,
+        opencodeDir,
+        opencodeDirExists,
+        configPath,
+        configExists,
+        configStatus,
+        configError,
+        examplePath,
+        exampleExists,
+        mode: configStatus === "loaded" ? "oMo-enabled" : "standard-opencode",
+        recommendedAgentsReady,
+        enabledAgents,
+        agents,
+        backgroundTasksConfigured,
+        autoResumeEnabled,
+        approvalWhitelist,
+        watchdogSuperviseReady,
+        autonomyReady,
+        claudeSettingsExamplePath,
+        claudeSettingsExampleExists,
+        approvalWhitelistHelperPath,
+        approvalWhitelistHelperExists,
+        approvalWhitelistRunnerPath,
+        approvalWhitelistRunnerExists,
+        approvalWhitelistWatchdogPath,
+        approvalWhitelistWatchdogExists,
+        tmuxScanHelperPath,
+        tmuxScanHelperExists,
+        tmuxRescueHelperPath,
+        tmuxRescueHelperExists,
+        rel: {
+            opencodeDir: relativeOrDot(path.relative(workspaceRoot, opencodeDir)),
+            configPath: relativeOrDot(path.relative(workspaceRoot, configPath)),
+            examplePath: relativeOrDot(path.relative(workspaceRoot, examplePath)),
+            claudeSettingsExamplePath: relativeOrDot(path.relative(workspaceRoot, claudeSettingsExamplePath)),
+            approvalWhitelistHelperPath: relativeOrDot(path.relative(workspaceRoot, approvalWhitelistHelperPath)),
+            approvalWhitelistRunnerPath: relativeOrDot(path.relative(workspaceRoot, approvalWhitelistRunnerPath)),
+            approvalWhitelistWatchdogPath: relativeOrDot(path.relative(workspaceRoot, approvalWhitelistWatchdogPath)),
+            tmuxScanHelperPath: relativeOrDot(path.relative(workspaceRoot, tmuxScanHelperPath)),
+            tmuxRescueHelperPath: relativeOrDot(path.relative(workspaceRoot, tmuxRescueHelperPath)),
+        },
+    };
+}
+//# sourceMappingURL=opencode-env.js.map

package/dist/opencode-env.js.map

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

package/dist/path-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function joinRel(rootDir: string, relPosix: string): string;
+export declare function normalizeRel(rel: string): string;

package/dist/path-utils.js

@@ -0,0 +1,8 @@
+import path from "node:path";
+export function joinRel(rootDir, relPosix) {
+    return path.join(rootDir, ...String(relPosix).split("/"));
+}
+export function normalizeRel(rel) {
+    return String(rel).replaceAll("\\", "/").replaceAll(/\/+/g, "/").replace(/^\/+/, "");
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../src/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,QAAgB;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACvF,CAAC"}

package/dist/spec.d.ts

@@ -0,0 +1,17 @@
+export interface SpecPackage {
+    rootDir: string;
+    version: string;
+}
+export declare function loadSpecPackage(): Promise<SpecPackage>;
+export interface Template {
+    templateId: string;
+    templateDir: string;
+    manifest: any;
+    specVersion: string;
+}
+export declare function loadTemplate(templateId: string): Promise<Template>;
+export declare function loadWorkflowGovernanceRules(): Promise<any>;
+export declare function loadWorkflowStageContracts(): Promise<any>;
+export declare function loadWorkflowRouterRules(): Promise<any>;
+export declare function loadWorkflowReviewGates(): Promise<any>;
+export declare function loadWorkflowDelegationContracts(): Promise<any>;

package/dist/spec.js

@@ -0,0 +1,174 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { pathExists, readText } from "./fs.js";
+import { UserError } from "./errors.js";
+import { validateJsonSchemaLite } from "./json-schema-lite.js";
+const specJsonDocCache = new Map();
+export async function loadSpecPackage() {
+    const require = createRequire(import.meta.url);
+    let pkgJsonPath = null;
+    try {
+        pkgJsonPath = require.resolve("@aipper/aiws-spec/package.json");
+    }
+    catch {
+        pkgJsonPath = null;
+    }
+    let rootDir;
+    if (pkgJsonPath) {
+        rootDir = path.dirname(pkgJsonPath);
+    }
+    else {
+        const here = fileURLToPath(import.meta.url);
+        rootDir = path.resolve(path.dirname(here), "../../spec");
+        const fallbackPkg = path.join(rootDir, "package.json");
+        if (!(await pathExists(fallbackPkg))) {
+            throw new UserError("Cannot locate @aipper/aiws-spec. Install it or run inside the monorepo.", {
+                exitCode: 1,
+            });
+        }
+    }
+    const pkg = JSON.parse(await readText(path.join(rootDir, "package.json")));
+    const version = String(pkg.version || "").trim() || "0.0.0";
+    return { rootDir, version };
+}
+export async function loadTemplate(templateId) {
+    if (!templateId || templateId.includes("..") || templateId.includes("/") || templateId.includes("\\")) {
+        throw new UserError(`Invalid template id: ${templateId}`);
+    }
+    const spec = await loadSpecPackage();
+    const templateDir = path.join(spec.rootDir, "templates", templateId);
+    const manifestPath = path.join(templateDir, "manifest.json");
+    try {
+        await fs.access(manifestPath);
+    }
+    catch {
+        throw new UserError(`Template not found: ${templateId}`, {
+            details: `Missing: ${manifestPath}`,
+        });
+    }
+    const manifest = JSON.parse(await readText(manifestPath));
+    return { templateId, templateDir, manifest, specVersion: spec.version };
+}
+async function loadSpecJsonDoc(relPath) {
+    const spec = await loadSpecPackage();
+    const absPath = path.join(spec.rootDir, relPath);
+    const cacheKey = `${spec.rootDir}:${relPath}`;
+    if (specJsonDocCache.has(cacheKey)) {
+        return { spec, data: specJsonDocCache.get(cacheKey), absPath };
+    }
+    const raw = await readText(absPath);
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new UserError(`Invalid JSON in spec doc: ${relPath}`, {
+            details: error instanceof Error ? error.message : String(error),
+        });
+    }
+    specJsonDocCache.set(cacheKey, data);
+    return { spec, data, absPath };
+}
+async function loadValidatedSpecJsonDoc(relPath, schemaRelPath) {
+    const loaded = await loadSpecJsonDoc(relPath);
+    const { data: schema } = await loadSpecJsonDoc(schemaRelPath);
+    validateJsonSchemaLite(loaded.data, schema, { source: loaded.absPath });
+    return loaded;
+}
+export async function loadWorkflowGovernanceRules() {
+    const relPath = path.join("docs", "workflow-governance-rules.json");
+    const schemaRelPath = path.join("docs", "workflow-governance-rules.schema.json");
+    const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
+    const governanceRules = data.governanceRules;
+    const guidanceRules = data.guidanceRules;
+    return {
+        ok: true,
+        source: "@aipper/aiws-spec/docs/workflow-governance-rules.json",
+        specVersion: spec.version,
+        version: Number(data?.version || 1),
+        description: String(data?.description || ""),
+        governanceRules,
+        guidanceRules,
+    };
+}
+export async function loadWorkflowStageContracts() {
+    const relPath = path.join("docs", "workflow-stage-contracts.json");
+    const schemaRelPath = path.join("docs", "workflow-stage-contracts.schema.json");
+    const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
+    const stages = data.stages;
+    return {
+        ok: true,
+        source: "@aipper/aiws-spec/docs/workflow-stage-contracts.json",
+        specVersion: spec.version,
+        version: Number(data?.version || 1),
+        description: String(data?.description || ""),
+        standardChain: Array.isArray(data?.standardChain) ? data.standardChain : [],
+        notes: Array.isArray(data?.notes) ? data.notes : [],
+        stages,
+    };
+}
+export async function loadWorkflowRouterRules() {
+    const relPath = path.join("docs", "workflow-router-rules.json");
+    const schemaRelPath = path.join("docs", "workflow-router-rules.schema.json");
+    const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
+    return {
+        ok: true,
+        source: "@aipper/aiws-spec/docs/workflow-router-rules.json",
+        specVersion: spec.version,
+        version: Number(data?.version || 1),
+        title: String(data?.title || ""),
+        description: String(data?.description || ""),
+        truthFiles: Array.isArray(data?.truthFiles) ? data.truthFiles : [],
+        bootstrapEntry: data.bootstrapEntry,
+        universalSequence: Array.isArray(data?.universalSequence) ? data.universalSequence : [],
+        routingRules: Array.isArray(data?.routingRules) ? data.routingRules : [],
+        routeCases: Array.isArray(data?.routeCases) ? data.routeCases : [],
+        clarificationTriggers: Array.isArray(data?.clarificationTriggers) ? data.clarificationTriggers : [],
+        universalRules: Array.isArray(data?.universalRules) ? data.universalRules : [],
+        notes: Array.isArray(data?.notes) ? data.notes : [],
+    };
+}
+export async function loadWorkflowReviewGates() {
+    const relPath = path.join("docs", "workflow-review-gates.json");
+    const schemaRelPath = path.join("docs", "workflow-review-gates.schema.json");
+    const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
+    return {
+        ok: true,
+        source: "@aipper/aiws-spec/docs/workflow-review-gates.json",
+        specVersion: spec.version,
+        version: Number(data?.version || 1),
+        title: String(data?.title || ""),
+        description: String(data?.description || ""),
+        gates: Array.isArray(data?.gates) ? data.gates : [],
+        unifiedRules: Array.isArray(data?.unifiedRules) ? data.unifiedRules : [],
+        evidence: Array.isArray(data?.evidence) ? data.evidence : [],
+        notes: Array.isArray(data?.notes) ? data.notes : [],
+    };
+}
+export async function loadWorkflowDelegationContracts() {
+    const relPath = path.join("docs", "workflow-delegation-contracts.json");
+    const schemaRelPath = path.join("docs", "workflow-delegation-contracts.schema.json");
+    const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
+    return {
+        ok: true,
+        source: "@aipper/aiws-spec/docs/workflow-delegation-contracts.json",
+        specVersion: spec.version,
+        version: Number(data?.version || 1),
+        title: String(data?.title || ""),
+        description: String(data?.description || ""),
+        purpose: Array.isArray(data?.purpose) ? data.purpose : [],
+        truthFiles: Array.isArray(data?.truthFiles) ? data.truthFiles : [],
+        delegationFlow: Array.isArray(data?.delegationFlow) ? data.delegationFlow : [],
+        roleTypes: Array.isArray(data?.roleTypes) ? data.roleTypes : [],
+        artifactTargets: Array.isArray(data?.artifactTargets) ? data.artifactTargets : [],
+        reviewConvergence: data?.reviewConvergence || {},
+        fallbackMode: data?.fallbackMode || {},
+        toolCapabilityMatrix: Array.isArray(data?.toolCapabilityMatrix) ? data.toolCapabilityMatrix : [],
+        universalRules: Array.isArray(data?.universalRules) ? data.universalRules : [],
+        reworkLoopProtocol: data?.reworkLoopProtocol || {},
+        notes: Array.isArray(data?.notes) ? data.notes : [],
+    };
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

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

package/dist/template.d.ts

@@ -0,0 +1,20 @@
+export declare function expandManifestEntries(templateDir: string, entries: string[]): Promise<string[]>;
+export declare function templatePath(templateDir: string, relPosix: string): string;
+export interface CopyTemplateFileOptions {
+    templateDir: string;
+    workspaceRoot: string;
+    relPosix: string;
+    chmod?: number;
+}
+export declare function copyTemplateFileToWorkspace(options: CopyTemplateFileOptions): Promise<void>;
+export interface ApplyManagedBlocksOptions {
+    templateDir: string;
+    workspaceRoot: string;
+    fileRel: string;
+    blockIds: string[];
+    insertIfMissing: boolean;
+}
+export declare function applyManagedBlocksFromTemplate(options: ApplyManagedBlocksOptions): Promise<{
+    changed: boolean;
+}>;
+export declare function ensureWorkspaceDir(workspaceRoot: string, relPosix: string): Promise<void>;

package/dist/template.js

@@ -0,0 +1,123 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { listFilesRecursive, pathExists, copyFile, readText, writeText, ensureDir } from "./fs.js";
+import { normalizeRel, joinRel } from "./path-utils.js";
+import { normalizeNewlines } from "./hash.js";
+import { extractTemplateBlock, upsertManagedBlock } from "./managed-blocks.js";
+import { UserError } from "./errors.js";
+function extractLeadingFrontmatter(text) {
+    const t = normalizeNewlines(text);
+    if (!t.startsWith("---\n"))
+        return null;
+    const end = t.indexOf("\n---\n", 4);
+    if (end === -1)
+        return null;
+    const closeEnd = end + "\n---\n".length;
+    return {
+        chunk: t.slice(0, closeEnd),
+        rest: t.slice(closeEnd),
+    };
+}
+function syncLeadingFrontmatter(currentText, templateText) {
+    const templateFm = extractLeadingFrontmatter(templateText);
+    if (!templateFm)
+        return { nextText: currentText, changed: false };
+    const currentFm = extractLeadingFrontmatter(currentText);
+    if (!currentFm) {
+        const nextText = `${templateFm.chunk}${currentText}`;
+        return { nextText, changed: nextText !== currentText };
+    }
+    const nextText = `${templateFm.chunk}${currentFm.rest}`;
+    return { nextText, changed: nextText !== currentText };
+}
+function templateRelCandidates(relPosix) {
+    const rel = normalizeRel(relPosix);
+    if (!rel)
+        return [];
+    const out = [rel];
+    if (rel === ".gitignore" || rel.endsWith("/.gitignore")) {
+        out.push(rel.replace(/(^|\/)\.gitignore$/, "$1gitignore"));
+    }
+    return Array.from(new Set(out));
+}
+async function resolveTemplateSourcePath(templateDir, relPosix) {
+    for (const cand of templateRelCandidates(relPosix)) {
+        const abs = templatePath(templateDir, cand);
+        if (await pathExists(abs))
+            return abs;
+    }
+    return templatePath(templateDir, relPosix);
+}
+export async function expandManifestEntries(templateDir, entries) {
+    const out = new Set();
+    for (const raw of entries) {
+        const e = normalizeRel(raw);
+        if (!e)
+            continue;
+        if (e.includes("**")) {
+            const idx = e.indexOf("**");
+            const prefix = e.slice(0, idx).replace(/\/+$/, "");
+            if (!prefix)
+                continue;
+            const files = await listFilesRecursive(templateDir, prefix);
+            for (const f of files)
+                out.add(normalizeRel(f));
+            continue;
+        }
+        out.add(e);
+    }
+    return Array.from(out).sort();
+}
+export function templatePath(templateDir, relPosix) {
+    const rel = normalizeRel(relPosix);
+    return path.join(templateDir, ...rel.split("/"));
+}
+export async function copyTemplateFileToWorkspace(options) {
+    const rel = normalizeRel(options.relPosix);
+    const src = await resolveTemplateSourcePath(options.templateDir, rel);
+    const dest = joinRel(options.workspaceRoot, rel);
+    if (!(await pathExists(src))) {
+        const tried = templateRelCandidates(rel).map((c) => templatePath(options.templateDir, c));
+        throw new UserError(`Template file missing: ${options.relPosix}`, { details: `Tried:\n- ${tried.join("\n- ")}` });
+    }
+    const copyOpts = typeof options.chmod === "number" ? { chmod: options.chmod } : {};
+    await copyFile(src, dest, Object.keys(copyOpts).length > 0 ? copyOpts : undefined);
+}
+export async function applyManagedBlocksFromTemplate(options) {
+    const fileRel = normalizeRel(options.fileRel);
+    const dest = joinRel(options.workspaceRoot, fileRel);
+    const src = await resolveTemplateSourcePath(options.templateDir, fileRel);
+    if (!(await pathExists(src))) {
+        const tried = templateRelCandidates(fileRel).map((c) => templatePath(options.templateDir, c));
+        throw new UserError(`Template file missing: ${fileRel}`, { details: `Tried:\n- ${tried.join("\n- ")}` });
+    }
+    const templateText = normalizeNewlines(await readText(src));
+    if (!(await pathExists(dest))) {
+        await ensureDir(path.dirname(dest));
+        await writeText(dest, templateText);
+        return { changed: true };
+    }
+    const currentText = normalizeNewlines(await readText(dest));
+    const syncedFrontmatter = syncLeadingFrontmatter(currentText, templateText);
+    let nextText = syncedFrontmatter.nextText;
+    let anyChanged = syncedFrontmatter.changed;
+    for (const blockId of options.blockIds) {
+        const { blockChunk, innerText } = extractTemplateBlock(templateText, blockId);
+        const res = upsertManagedBlock(nextText, blockId, innerText, {
+            insertIfMissing: options.insertIfMissing,
+            templateBlockChunk: blockChunk,
+        });
+        nextText = res.nextText;
+        if (res.changed)
+            anyChanged = true;
+    }
+    if (anyChanged) {
+        await writeText(dest, nextText);
+    }
+    return { changed: anyChanged };
+}
+export async function ensureWorkspaceDir(workspaceRoot, relPosix) {
+    const abs = joinRel(workspaceRoot, relPosix);
+    await fs.mkdir(abs, { recursive: true });
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,4 @@
+export interface ResolveWorkspaceRootOptions {
+    create?: boolean;
+}
+export declare function resolveWorkspaceRoot(targetPath: string, options?: ResolveWorkspaceRootOptions): Promise<string>;

package/dist/workspace.js

@@ -0,0 +1,19 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { pathExists } from "./fs.js";
+import { UserError } from "./errors.js";
+export async function resolveWorkspaceRoot(targetPath, options) {
+    const abs = path.resolve(process.cwd(), targetPath || ".");
+    if (await pathExists(abs)) {
+        const st = await fs.stat(abs);
+        if (!st.isDirectory())
+            throw new UserError(`Not a directory: ${abs}`);
+        return abs;
+    }
+    if (options?.create) {
+        await fs.mkdir(abs, { recursive: true });
+        return abs;
+    }
+    throw new UserError(`Path does not exist: ${abs}`);
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMxC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,OAAqC;IAErC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,IAAI,GAAG,CAAC,CAAC;IAC3D,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE;YAAE,MAAM,IAAI,SAAS,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;QACtE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/package.json

@@ -1,24 +1,32 @@
 {
   "name": "@aipper/aiws",
-  "version": "0.0.29",
+  "version": "0.0.30",
   "description": "AI Workspace CLI (init/update/validate) for Claude Code / OpenCode / Codex.",
   "type": "module",
   "bin": {
     "aiws": "./bin/aiws.js"
   },
   "dependencies": {
-    "@aipper/aiws-spec": "0.0.29"
+    "@aipper/aiws-spec": "0.0.30"
   },
   "files": [
     "bin",
-    "src",
+    "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsc && cp src/dashboard/index.html src/dashboard/style.css dist/dashboard/",
+    "prepack": "npm run build"
+  },
   "engines": {
     "node": ">=20"
   },
   "license": "MIT",
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.0",
+    "typescript": "^6.0.3"
   }
 }