@baoanaz/cviauto 0.6.5

package/dist/configurators/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"AAuCA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAOtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,WAAW,EAAE,WAAW,CAAC;IACzB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAkEf"}

package/dist/configurators/workflow.js

@@ -0,0 +1,177 @@
+import path from "node:path";
+import { DIR_NAMES, PATHS } from "../constants/paths.js";
+import { copyTrellisDir } from "../templates/extract.js";
+// Import trellis templates (generic, not project-specific)
+import { workflowMdTemplate, configYamlTemplate, gitignoreTemplate, getAllAgents, } from "../templates/trellis/index.js";
+// Import markdown templates
+import { agentProgressIndexContent, 
+// Backend structure (multi-doc)
+backendIndexContent, backendDirectoryStructureContent, backendDatabaseGuidelinesContent, backendLoggingGuidelinesContent, backendQualityGuidelinesContent, backendErrorHandlingContent, 
+// Frontend structure (multi-doc)
+frontendIndexContent, frontendDirectoryStructureContent, frontendTypeSafetyContent, frontendHookGuidelinesContent, frontendComponentGuidelinesContent, frontendQualityGuidelinesContent, frontendStateManagementContent, 
+// Guides structure
+guidesIndexContent, guidesCrossLayerThinkingGuideContent, guidesCodeReuseThinkingGuideContent, } from "../templates/markdown/index.js";
+import { writeFile, ensureDir } from "../utils/file-writer.js";
+import { replacePythonCommandLiterals } from "./shared.js";
+import { sanitizePkgName, } from "../utils/project-detector.js";
+/**
+ * Create workflow structure based on project type
+ *
+ * This function creates the .cviauto/ directory structure by:
+ * 1. Copying scripts/ directory directly (dogfooding)
+ * 2. Copying workflow.md and .gitignore (dogfooding)
+ * 3. Creating workspace/ with index.md
+ * 4. Creating tasks/ directory
+ * 5. Creating spec/ with templates (not dogfooded - generic templates)
+ *
+ * @param cwd - Current working directory
+ * @param options - Workflow options including project type
+ */
+export async function createWorkflowStructure(cwd, options) {
+    const projectType = options?.projectType ?? "fullstack";
+    const skipSpecTemplates = options?.skipSpecTemplates ?? false;
+    const packages = options?.packages;
+    const remoteSpecPackages = options?.remoteSpecPackages;
+    const workflowMd = options?.workflowMdOverride ?? workflowMdTemplate;
+    // Create base .cviauto directory
+    ensureDir(path.join(cwd, DIR_NAMES.WORKFLOW));
+    // Copy scripts/ directory from templates
+    await copyTrellisDir("scripts", path.join(cwd, PATHS.SCRIPTS), {
+        executable: true,
+    });
+    // Copy workflow.md (native bundled template or selected marketplace variant)
+    await writeFile(path.join(cwd, PATHS.WORKFLOW_GUIDE_FILE), replacePythonCommandLiterals(workflowMd));
+    // Copy .gitignore from templates
+    await writeFile(path.join(cwd, DIR_NAMES.WORKFLOW, ".gitignore"), gitignoreTemplate);
+    // Copy config.yaml from templates
+    await writeFile(path.join(cwd, DIR_NAMES.WORKFLOW, "config.yaml"), configYamlTemplate);
+    // Dispatch channel runtime agent definitions. These are platform-agnostic
+    // Trellis runtime files consumed by `cviauto channel spawn --agent <name>`
+    // through `packages/cli/src/commands/channel/agent-loader.ts`. They are
+    // dispatched on every init regardless of selected workflow because the user
+    // can switch to a channel-driven workflow at any time via `cviauto workflow
+    // --template`.
+    ensureDir(path.join(cwd, PATHS.AGENTS));
+    for (const [agentFile, content] of getAllAgents()) {
+        await writeFile(path.join(cwd, PATHS.AGENTS, agentFile), content);
+    }
+    // Create workspace/ with index.md
+    ensureDir(path.join(cwd, PATHS.WORKSPACE));
+    await writeFile(path.join(cwd, PATHS.WORKSPACE, "index.md"), replacePythonCommandLiterals(agentProgressIndexContent));
+    // Create tasks/ directory
+    ensureDir(path.join(cwd, PATHS.TASKS));
+    // Create spec templates based on project type
+    // These are NOT dogfooded - they are generic templates for new projects
+    if (packages && packages.length > 0) {
+        // Monorepo mode: create per-package spec directories unless a registry
+        // already installed the full .cviauto/spec tree.
+        if (!skipSpecTemplates) {
+            await createSpecTemplates(cwd, projectType, packages, remoteSpecPackages);
+        }
+    }
+    else if (!skipSpecTemplates) {
+        // Single-repo mode: create global spec (skip if using remote template)
+        await createSpecTemplates(cwd, projectType);
+    }
+}
+/**
+ * Write backend spec docs into a target spec directory.
+ */
+async function writeBackendDocs(specBase) {
+    const backendDir = path.join(specBase, "backend");
+    ensureDir(backendDir);
+    const docs = [
+        { name: "index.md", content: backendIndexContent },
+        {
+            name: "directory-structure.md",
+            content: backendDirectoryStructureContent,
+        },
+        {
+            name: "database-guidelines.md",
+            content: backendDatabaseGuidelinesContent,
+        },
+        { name: "logging-guidelines.md", content: backendLoggingGuidelinesContent },
+        { name: "quality-guidelines.md", content: backendQualityGuidelinesContent },
+        { name: "error-handling.md", content: backendErrorHandlingContent },
+    ];
+    for (const doc of docs) {
+        await writeFile(path.join(backendDir, doc.name), doc.content);
+    }
+}
+/**
+ * Write frontend spec docs into a target spec directory.
+ */
+async function writeFrontendDocs(specBase) {
+    const frontendDir = path.join(specBase, "frontend");
+    ensureDir(frontendDir);
+    const docs = [
+        { name: "index.md", content: frontendIndexContent },
+        {
+            name: "directory-structure.md",
+            content: frontendDirectoryStructureContent,
+        },
+        { name: "type-safety.md", content: frontendTypeSafetyContent },
+        { name: "hook-guidelines.md", content: frontendHookGuidelinesContent },
+        {
+            name: "component-guidelines.md",
+            content: frontendComponentGuidelinesContent,
+        },
+        {
+            name: "quality-guidelines.md",
+            content: frontendQualityGuidelinesContent,
+        },
+        { name: "state-management.md", content: frontendStateManagementContent },
+    ];
+    for (const doc of docs) {
+        await writeFile(path.join(frontendDir, doc.name), doc.content);
+    }
+}
+/**
+ * Write spec docs for a given project type into a target spec directory.
+ */
+async function writeSpecForType(specBase, projectType) {
+    if (projectType !== "frontend") {
+        await writeBackendDocs(specBase);
+    }
+    if (projectType !== "backend") {
+        await writeFrontendDocs(specBase);
+    }
+}
+async function createSpecTemplates(cwd, projectType, packages, remoteSpecPackages) {
+    // Ensure spec directory exists
+    ensureDir(path.join(cwd, PATHS.SPEC));
+    // Guides - always created regardless of mode
+    const guidesDir = path.join(cwd, `${PATHS.SPEC}/guides`);
+    ensureDir(guidesDir);
+    const guidesDocs = [
+        { name: "index.md", content: guidesIndexContent },
+        {
+            name: "cross-layer-thinking-guide.md",
+            content: guidesCrossLayerThinkingGuideContent,
+        },
+        {
+            name: "code-reuse-thinking-guide.md",
+            content: guidesCodeReuseThinkingGuideContent,
+        },
+    ];
+    for (const doc of guidesDocs) {
+        await writeFile(path.join(guidesDir, doc.name), doc.content);
+    }
+    if (packages && packages.length > 0) {
+        // Monorepo mode: create spec/<name>/ for each package
+        for (const pkg of packages) {
+            const dirName = sanitizePkgName(pkg.name);
+            if (remoteSpecPackages?.has(dirName))
+                continue;
+            const pkgSpecBase = path.join(cwd, `${PATHS.SPEC}/${dirName}`);
+            ensureDir(pkgSpecBase);
+            const pkgType = pkg.type === "unknown" ? "fullstack" : pkg.type;
+            await writeSpecForType(pkgSpecBase, pkgType);
+        }
+    }
+    else {
+        // Single-repo mode
+        await writeSpecForType(path.join(cwd, PATHS.SPEC), projectType);
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/configurators/workflow.js.map

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

package/dist/configurators/zcode.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ZCode configurator.
+ *
+ * ZCode (智谱) is a pull-based class-2 platform (agentCapable, no hooks).
+ * Three output paths:
+ * - `.agents/skills/` — shared skills, byte-identical with Codex/Gemini writes
+ * - `.zcode/commands/cviauto/` — slash commands (invoked as /cviauto:<name>)
+ * - `.zcode/cli/agents/` — sub-agent definitions with pull-based prelude
+ */
+/**
+ * Collect all ZCode template files for `cviauto update` diff tracking.
+ * Must stay in sync with `configureZcode`.
+ */
+export declare function collectZcodeTemplates(): Map<string, string>;
+/**
+ * Configure ZCode at init time: write shared skills, commands, and sub-agents.
+ */
+export declare function configureZcode(cwd: string): Promise<void>;
+//# sourceMappingURL=zcode.d.ts.map

package/dist/configurators/zcode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zcode.d.ts","sourceRoot":"","sources":["../../src/configurators/zcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyB3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB/D"}

package/dist/configurators/zcode.js

@@ -0,0 +1,54 @@
+/**
+ * ZCode configurator.
+ *
+ * ZCode (智谱) is a pull-based class-2 platform (agentCapable, no hooks).
+ * Three output paths:
+ * - `.agents/skills/` — shared skills, byte-identical with Codex/Gemini writes
+ * - `.zcode/commands/cviauto/` — slash commands (invoked as /cviauto:<name>)
+ * - `.zcode/cli/agents/` — sub-agent definitions with pull-based prelude
+ */
+import path from "node:path";
+import { AI_TOOLS } from "../types/ai-tools.js";
+import { ensureDir, writeFile } from "../utils/file-writer.js";
+import { getAllAgents } from "../templates/zcode/index.js";
+import { collectSkillTemplates, resolveSkillsNeutral, resolveBundledSkills, resolveCommands, writeSkills, writeAgents, applyPullBasedPreludeMarkdown, } from "./shared.js";
+/**
+ * Collect all ZCode template files for `cviauto update` diff tracking.
+ * Must stay in sync with `configureZcode`.
+ */
+export function collectZcodeTemplates() {
+    const config = AI_TOOLS.zcode;
+    const ctx = config.templateContext;
+    const files = new Map();
+    // 1. Shared skills → .agents/skills/ (byte-identical with Codex/Gemini)
+    for (const [filePath, content] of collectSkillTemplates(".agents/skills", resolveSkillsNeutral(ctx), resolveBundledSkills(ctx))) {
+        files.set(filePath, content);
+    }
+    // 2. Commands → .zcode/commands/cviauto/
+    for (const cmd of resolveCommands(ctx)) {
+        files.set(`.zcode/commands/cviauto/${cmd.name}.md`, cmd.content);
+    }
+    // 3. Sub-agents → .zcode/cli/agents/ (with pull-based prelude)
+    for (const agent of applyPullBasedPreludeMarkdown(getAllAgents())) {
+        files.set(`.zcode/cli/agents/${agent.name}.md`, agent.content);
+    }
+    return files;
+}
+/**
+ * Configure ZCode at init time: write shared skills, commands, and sub-agents.
+ */
+export async function configureZcode(cwd) {
+    const config = AI_TOOLS.zcode;
+    const ctx = config.templateContext;
+    // 1. Shared skills → .agents/skills/
+    await writeSkills(path.join(cwd, ".agents", "skills"), resolveSkillsNeutral(ctx), resolveBundledSkills(ctx));
+    // 2. Commands → .zcode/commands/cviauto/
+    const commandsDir = path.join(cwd, ".zcode", "commands", "cviauto");
+    ensureDir(commandsDir);
+    for (const cmd of resolveCommands(ctx)) {
+        await writeFile(path.join(commandsDir, `${cmd.name}.md`), cmd.content);
+    }
+    // 3. Sub-agents → .zcode/cli/agents/ (with pull-based prelude)
+    await writeAgents(path.join(cwd, ".zcode", "cli", "agents"), applyPullBasedPreludeMarkdown(getAllAgents()));
+}
+//# sourceMappingURL=zcode.js.map

package/dist/configurators/zcode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zcode.js","sourceRoot":"","sources":["../../src/configurators/zcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,WAAW,EACX,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,wEAAwE;IACxE,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,qBAAqB,CACrD,gBAAgB,EAChB,oBAAoB,CAAC,GAAG,CAAC,EACzB,oBAAoB,CAAC,GAAG,CAAC,CAC1B,EAAE,CAAC;QACF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,yCAAyC;IACzC,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,GAAG,CAAC,2BAA2B,GAAG,CAAC,IAAI,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,+DAA+D;IAC/D,KAAK,MAAM,KAAK,IAAI,6BAA6B,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;QAClE,KAAK,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,IAAI,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC;IAEnC,qCAAqC;IACrC,MAAM,WAAW,CACf,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,EACnC,oBAAoB,CAAC,GAAG,CAAC,EACzB,oBAAoB,CAAC,GAAG,CAAC,CAC1B,CAAC;IAEF,yCAAyC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACpE,SAAS,CAAC,WAAW,CAAC,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,+DAA+D;IAC/D,MAAM,WAAW,CACf,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EACzC,6BAA6B,CAAC,YAAY,EAAE,CAAC,CAC9C,CAAC;AACJ,CAAC"}

package/dist/constants/paths.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Path constants for Cviauto workflow structure
+ *
+ * Change these values to rename directories across the entire project.
+ * All paths should be relative to the project root.
+ */
+export declare const DIR_NAMES: {
+    /** Root workflow directory */
+    readonly WORKFLOW: ".cviauto";
+    /** Workspace directory (under .cviauto/) - developer work areas */
+    readonly WORKSPACE: "workspace";
+    /** Tasks directory (under .cviauto/) - unified task storage */
+    readonly TASKS: "tasks";
+    /** Archive directory (under tasks/) */
+    readonly ARCHIVE: "archive";
+    /** Spec/guidelines directory (under .cviauto/) */
+    readonly SPEC: "spec";
+    /** Scripts directory (under .cviauto/) */
+    readonly SCRIPTS: "scripts";
+    /** Channel runtime agent definitions (under .cviauto/) */
+    readonly AGENTS: "agents";
+};
+export declare const FILE_NAMES: {
+    /** Root agent instructions file */
+    readonly AGENTS: "AGENTS.md";
+    /** Developer identity file */
+    readonly DEVELOPER: ".developer";
+    /** Current task pointer */
+    readonly CURRENT_TASK: ".current-task";
+    /** Task metadata */
+    readonly TASK_JSON: "task.json";
+    /** Requirements document */
+    readonly PRD: "prd.md";
+    /** Workflow guide */
+    readonly WORKFLOW_GUIDE: "workflow.md";
+    /** Journal file prefix */
+    readonly JOURNAL_PREFIX: "journal-";
+};
+export declare const PATHS: {
+    /** .cviauto/ */
+    readonly WORKFLOW: ".cviauto";
+    /** .cviauto/workspace/ */
+    readonly WORKSPACE: ".cviauto/workspace";
+    /** .cviauto/tasks/ */
+    readonly TASKS: ".cviauto/tasks";
+    /** .cviauto/spec/ */
+    readonly SPEC: ".cviauto/spec";
+    /** .cviauto/scripts/ */
+    readonly SCRIPTS: ".cviauto/scripts";
+    /** .cviauto/agents/ */
+    readonly AGENTS: ".cviauto/agents";
+    /** .cviauto/.developer */
+    readonly DEVELOPER_FILE: ".cviauto/.developer";
+    /** .cviauto/.current-task */
+    readonly CURRENT_TASK_FILE: ".cviauto/.current-task";
+    /** .cviauto/workflow.md */
+    readonly WORKFLOW_GUIDE_FILE: ".cviauto/workflow.md";
+};
+/**
+ * Get developer's workspace directory path
+ * @example getWorkspaceDir("john") => ".cviauto/workspace/john"
+ */
+export declare function getWorkspaceDir(developer: string): string;
+/**
+ * Get task directory path
+ * @example getTaskDir("01-21-my-task") => ".cviauto/tasks/01-21-my-task"
+ */
+export declare function getTaskDir(taskName: string): string;
+/**
+ * Get archive directory path
+ * @example getArchiveDir() => ".cviauto/tasks/archive"
+ */
+export declare function getArchiveDir(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/constants/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,SAAS;IACpB,8BAA8B;;IAE9B,mEAAmE;;IAEnE,+DAA+D;;IAE/D,uCAAuC;;IAEvC,kDAAkD;;IAElD,0CAA0C;;IAE1C,0DAA0D;;CAElD,CAAC;AAGX,eAAO,MAAM,UAAU;IACrB,mCAAmC;;IAEnC,8BAA8B;;IAE9B,2BAA2B;;IAE3B,oBAAoB;;IAEpB,4BAA4B;;IAE5B,qBAAqB;;IAErB,0BAA0B;;CAElB,CAAC;AAGX,eAAO,MAAM,KAAK;IAChB,gBAAgB;;IAEhB,0BAA0B;;IAE1B,sBAAsB;;IAEtB,qBAAqB;;IAErB,wBAAwB;;IAExB,uBAAuB;;IAEvB,0BAA0B;;IAE1B,6BAA6B;;IAE7B,2BAA2B;;CAEnB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/constants/paths.js

@@ -0,0 +1,83 @@
+/**
+ * Path constants for Cviauto workflow structure
+ *
+ * Change these values to rename directories across the entire project.
+ * All paths should be relative to the project root.
+ */
+// Directory names (can be renamed)
+export const DIR_NAMES = {
+    /** Root workflow directory */
+    WORKFLOW: ".cviauto",
+    /** Workspace directory (under .cviauto/) - developer work areas */
+    WORKSPACE: "workspace",
+    /** Tasks directory (under .cviauto/) - unified task storage */
+    TASKS: "tasks",
+    /** Archive directory (under tasks/) */
+    ARCHIVE: "archive",
+    /** Spec/guidelines directory (under .cviauto/) */
+    SPEC: "spec",
+    /** Scripts directory (under .cviauto/) */
+    SCRIPTS: "scripts",
+    /** Channel runtime agent definitions (under .cviauto/) */
+    AGENTS: "agents",
+};
+// File names
+export const FILE_NAMES = {
+    /** Root agent instructions file */
+    AGENTS: "AGENTS.md",
+    /** Developer identity file */
+    DEVELOPER: ".developer",
+    /** Current task pointer */
+    CURRENT_TASK: ".current-task",
+    /** Task metadata */
+    TASK_JSON: "task.json",
+    /** Requirements document */
+    PRD: "prd.md",
+    /** Workflow guide */
+    WORKFLOW_GUIDE: "workflow.md",
+    /** Journal file prefix */
+    JOURNAL_PREFIX: "journal-",
+};
+// Constructed paths (relative to project root)
+export const PATHS = {
+    /** .cviauto/ */
+    WORKFLOW: DIR_NAMES.WORKFLOW,
+    /** .cviauto/workspace/ */
+    WORKSPACE: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.WORKSPACE}`,
+    /** .cviauto/tasks/ */
+    TASKS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.TASKS}`,
+    /** .cviauto/spec/ */
+    SPEC: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.SPEC}`,
+    /** .cviauto/scripts/ */
+    SCRIPTS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.SCRIPTS}`,
+    /** .cviauto/agents/ */
+    AGENTS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.AGENTS}`,
+    /** .cviauto/.developer */
+    DEVELOPER_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.DEVELOPER}`,
+    /** .cviauto/.current-task */
+    CURRENT_TASK_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.CURRENT_TASK}`,
+    /** .cviauto/workflow.md */
+    WORKFLOW_GUIDE_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.WORKFLOW_GUIDE}`,
+};
+/**
+ * Get developer's workspace directory path
+ * @example getWorkspaceDir("john") => ".cviauto/workspace/john"
+ */
+export function getWorkspaceDir(developer) {
+    return `${PATHS.WORKSPACE}/${developer}`;
+}
+/**
+ * Get task directory path
+ * @example getTaskDir("01-21-my-task") => ".cviauto/tasks/01-21-my-task"
+ */
+export function getTaskDir(taskName) {
+    return `${PATHS.TASKS}/${taskName}`;
+}
+/**
+ * Get archive directory path
+ * @example getArchiveDir() => ".cviauto/tasks/archive"
+ */
+export function getArchiveDir() {
+    return `${PATHS.TASKS}/${DIR_NAMES.ARCHIVE}`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/constants/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mCAAmC;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,8BAA8B;IAC9B,QAAQ,EAAE,UAAU;IACpB,mEAAmE;IACnE,SAAS,EAAE,WAAW;IACtB,+DAA+D;IAC/D,KAAK,EAAE,OAAO;IACd,uCAAuC;IACvC,OAAO,EAAE,SAAS;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM;IACZ,0CAA0C;IAC1C,OAAO,EAAE,SAAS;IAClB,0DAA0D;IAC1D,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,aAAa;AACb,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mCAAmC;IACnC,MAAM,EAAE,WAAW;IACnB,8BAA8B;IAC9B,SAAS,EAAE,YAAY;IACvB,2BAA2B;IAC3B,YAAY,EAAE,eAAe;IAC7B,oBAAoB;IACpB,SAAS,EAAE,WAAW;IACtB,4BAA4B;IAC5B,GAAG,EAAE,QAAQ;IACb,qBAAqB;IACrB,cAAc,EAAE,aAAa;IAC7B,0BAA0B;IAC1B,cAAc,EAAE,UAAU;CAClB,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,gBAAgB;IAChB,QAAQ,EAAE,SAAS,CAAC,QAAQ;IAC5B,0BAA0B;IAC1B,SAAS,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE;IACzD,sBAAsB;IACtB,KAAK,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,KAAK,EAAE;IACjD,qBAAqB;IACrB,IAAI,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE;IAC/C,wBAAwB;IACxB,OAAO,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,OAAO,EAAE;IACrD,uBAAuB;IACvB,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE;IACnD,0BAA0B;IAC1B,cAAc,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,UAAU,CAAC,SAAS,EAAE;IAC/D,6BAA6B;IAC7B,iBAAiB,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,UAAU,CAAC,YAAY,EAAE;IACrE,2BAA2B;IAC3B,mBAAmB,EAAE,GAAG,SAAS,CAAC,QAAQ,IAAI,UAAU,CAAC,cAAc,EAAE;CACjE,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,GAAG,KAAK,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/dist/constants/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Package version and name constants.
+ *
+ * Extracted from cli/index.ts to avoid import-time side effects
+ * (program.parse(), checkForUpdates, etc.) when only VERSION is needed.
+ */
+export declare const VERSION: string;
+export declare const PACKAGE_NAME: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/constants/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/constants/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,eAAO,MAAM,OAAO,EAAE,MAA4B,CAAC;AACnD,eAAO,MAAM,YAAY,EAAE,MAAyB,CAAC"}

package/dist/constants/version.js

@@ -0,0 +1,15 @@
+/**
+ * Package version and name constants.
+ *
+ * Extracted from cli/index.ts to avoid import-time side effects
+ * (program.parse(), checkForUpdates, etc.) when only VERSION is needed.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = path.resolve(__dirname, "../../package.json");
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+export const VERSION = packageJson.version;
+export const PACKAGE_NAME = packageJson.name;
+//# sourceMappingURL=version.js.map

package/dist/constants/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/constants/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AACtE,MAAM,WAAW,GAAgB,IAAI,CAAC,KAAK,CACzC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC,OAAO,CAAC;AACnD,MAAM,CAAC,MAAM,YAAY,GAAW,WAAW,CAAC,IAAI,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Trellis - AI-assisted development workflow framework
+ *
+ * Based on Anthropic's "Effective Harnesses for Long-Running Agents"
+ * https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
+ */
+export { VERSION } from "./constants/version.js";
+export { init } from "./commands/init.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Trellis - AI-assisted development workflow framework
+ *
+ * Based on Anthropic's "Effective Harnesses for Long-Running Agents"
+ * https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
+ */
+export { VERSION } from "./constants/version.js";
+export { init } from "./commands/init.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Migration manifests for Trellis versions
+ *
+ * Each version's migrations are stored in separate JSON files under manifests/
+ * Format: manifests/{version}.json (e.g., manifests/0.1.9.json)
+ */
+import type { ConfigSectionAdded, MigrationItem } from "../types/migration.js";
+/**
+ * Get all migrations needed to upgrade from one version to another
+ *
+ * @param fromVersion - Current installed version
+ * @param toVersion - Target version to upgrade to
+ * @returns Array of migration items to apply, in version order
+ */
+export declare function getMigrationsForVersion(fromVersion: string, toVersion: string): MigrationItem[];
+/**
+ * Check if there are any pending migrations between versions
+ */
+export declare function hasPendingMigrations(fromVersion: string, toVersion: string): boolean;
+/**
+ * Get human-readable summary of pending migrations
+ */
+export declare function getMigrationSummary(fromVersion: string, toVersion: string): {
+    renames: number;
+    deletes: number;
+    safeFileDeletes: number;
+};
+/**
+ * Get all registered migration versions
+ */
+export declare function getAllMigrationVersions(): string[];
+/**
+ * Get ALL migrations from all manifests (regardless of version)
+ * Used for detecting orphaned migrations that should have been applied
+ */
+export declare function getAllMigrations(): MigrationItem[];
+/**
+ * Clear the manifest cache (useful for testing)
+ */
+export declare function clearManifestCache(): void;
+/**
+ * Collect every `configSectionsAdded` entry from manifests strictly between
+ * `fromVersion` (exclusive) and `toVersion` (inclusive). Used by `update.ts`
+ * to apply additive config.yaml sections that were introduced after the
+ * user's installed version.
+ */
+export declare function getConfigSectionsAddedBetween(fromVersion: string, toVersion: string): ConfigSectionAdded[];
+/**
+ * Get aggregated metadata for migrations between versions
+ * Returns combined changelog, breaking status, migrate recommendation, and migration guides
+ */
+export declare function getMigrationMetadata(fromVersion: string, toVersion: string): {
+    changelog: string[];
+    breaking: boolean;
+    recommendMigrate: boolean;
+    migrationGuides: {
+        version: string;
+        guide: string;
+        aiInstructions?: string;
+    }[];
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAoD/B;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,aAAa,EAAE,CAuBjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAQ/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAGlD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,EAAE,CAOlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,kBAAkB,EAAE,CAkBtB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB;IACD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;CACL,CA6CA"}