@blxzer/cursor-trellis 0.1.0

package/dist/configurators/workflow.d.ts

@@ -0,0 +1,46 @@
+import { type ProjectType, type DetectedPackage } from "../utils/project-detector.js";
+/**
+ * Options for creating workflow structure
+ */
+export interface WorkflowOptions {
+    /** Detected or specified project type */
+    projectType: ProjectType;
+    /** Skip creating local spec templates (when using remote template) — single-repo mode */
+    skipSpecTemplates?: boolean;
+    /** Detected monorepo packages (enables monorepo spec creation) */
+    packages?: DetectedPackage[];
+    /** Package names that use remote templates (skip blank spec for these) */
+    remoteSpecPackages?: Set<string>;
+    /**
+     * Optional override for `.trellis/workflow.md` content. When omitted the
+     * bundled native template is written. Set by `init --workflow` (or
+     * `--workflow-source`) after the resolver has fetched marketplace content.
+     * Caller is still responsible for removing the `.trellis/workflow.md` hash
+     * entry for non-native workflows so update.ts treats them as user-managed.
+     */
+    workflowMdOverride?: string;
+    /**
+     * Whether to materialize the Cursor++ BYOK local operator bundle
+     * (`.trellis/local/cursor2plus/`). Defaults to `false` from 1.1.0: only
+     * written when the user opts in during `trellis init` (interactive BYOK
+     * question) or passes `--cursor2plus`. Native Cursor API users do not need
+     * these assets. `trellis update` keeps existing bundles (detected by
+     * directory presence) regardless of this flag.
+     */
+    cursor2plus?: boolean;
+}
+/**
+ * Create workflow structure based on project type
+ *
+ * This function creates the .trellis/ 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 declare function createWorkflowStructure(cwd: string, options?: WorkflowOptions): Promise<void>;
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"AA0CA,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;IAC5B;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/configurators/workflow.js

@@ -0,0 +1,180 @@
+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, } 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, guidesDurableLearningDecisionGuideContent, guidesRetrievalDailyGuideContent, guidesCursorSubagentPolicyContent, } from "../templates/markdown/index.js";
+import { writeFile, ensureDir } from "../utils/file-writer.js";
+import { replacePythonCommandLiterals } from "./shared.js";
+import { writeCursor2plusLocalBundle } from "./cursor2plus-local.js";
+import { sanitizePkgName, } from "../utils/project-detector.js";
+/**
+ * Create workflow structure based on project type
+ *
+ * This function creates the .trellis/ 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 .trellis 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);
+    // 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));
+    if (options?.cursor2plus) {
+        await writeCursor2plusLocalBundle(cwd);
+    }
+    // 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
+        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: "durable-learning-decision-guide.md",
+            content: guidesDurableLearningDecisionGuideContent,
+        },
+        {
+            name: "cross-layer-thinking-guide.md",
+            content: guidesCrossLayerThinkingGuideContent,
+        },
+        {
+            name: "code-reuse-thinking-guide.md",
+            content: guidesCodeReuseThinkingGuideContent,
+        },
+        {
+            name: "retrieval-daily-guide.md",
+            content: guidesRetrievalDailyGuideContent,
+        },
+        {
+            name: "cursor-subagent-policy.md",
+            content: guidesCursorSubagentPolicyContent,
+        },
+    ];
+    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/constants/paths.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Path constants for Trellis 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: ".trellis";
+    /** Workspace directory (under .trellis/) - developer work areas */
+    readonly WORKSPACE: "workspace";
+    /** Tasks directory (under .trellis/) - unified task storage */
+    readonly TASKS: "tasks";
+    /** Archive directory (under tasks/) */
+    readonly ARCHIVE: "archive";
+    /** Spec/guidelines directory (under .trellis/) */
+    readonly SPEC: "spec";
+    /** Scripts directory (under .trellis/) */
+    readonly SCRIPTS: "scripts";
+};
+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: {
+    /** .trellis/ */
+    readonly WORKFLOW: ".trellis";
+    /** .trellis/workspace/ */
+    readonly WORKSPACE: ".trellis/workspace";
+    /** .trellis/tasks/ */
+    readonly TASKS: ".trellis/tasks";
+    /** .trellis/spec/ */
+    readonly SPEC: ".trellis/spec";
+    /** .trellis/scripts/ */
+    readonly SCRIPTS: ".trellis/scripts";
+    /** .trellis/.developer */
+    readonly DEVELOPER_FILE: ".trellis/.developer";
+    /** .trellis/.current-task */
+    readonly CURRENT_TASK_FILE: ".trellis/.current-task";
+    /** .trellis/workflow.md */
+    readonly WORKFLOW_GUIDE_FILE: ".trellis/workflow.md";
+};
+/**
+ * Get developer's workspace directory path
+ * @example getWorkspaceDir("john") => ".trellis/workspace/john"
+ */
+export declare function getWorkspaceDir(developer: string): string;
+/**
+ * Get task directory path
+ * @example getTaskDir("01-21-my-task") => ".trellis/tasks/01-21-my-task"
+ */
+export declare function getTaskDir(taskName: string): string;
+/**
+ * Get archive directory path
+ * @example getArchiveDir() => ".trellis/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;;CAElC,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,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,79 @@
+/**
+ * Path constants for Trellis 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: ".trellis",
+    /** Workspace directory (under .trellis/) - developer work areas */
+    WORKSPACE: "workspace",
+    /** Tasks directory (under .trellis/) - unified task storage */
+    TASKS: "tasks",
+    /** Archive directory (under tasks/) */
+    ARCHIVE: "archive",
+    /** Spec/guidelines directory (under .trellis/) */
+    SPEC: "spec",
+    /** Scripts directory (under .trellis/) */
+    SCRIPTS: "scripts",
+};
+// 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 = {
+    /** .trellis/ */
+    WORKFLOW: DIR_NAMES.WORKFLOW,
+    /** .trellis/workspace/ */
+    WORKSPACE: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.WORKSPACE}`,
+    /** .trellis/tasks/ */
+    TASKS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.TASKS}`,
+    /** .trellis/spec/ */
+    SPEC: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.SPEC}`,
+    /** .trellis/scripts/ */
+    SCRIPTS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.SCRIPTS}`,
+    /** .trellis/.developer */
+    DEVELOPER_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.DEVELOPER}`,
+    /** .trellis/.current-task */
+    CURRENT_TASK_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.CURRENT_TASK}`,
+    /** .trellis/workflow.md */
+    WORKFLOW_GUIDE_FILE: `${DIR_NAMES.WORKFLOW}/${FILE_NAMES.WORKFLOW_GUIDE}`,
+};
+/**
+ * Get developer's workspace directory path
+ * @example getWorkspaceDir("john") => ".trellis/workspace/john"
+ */
+export function getWorkspaceDir(developer) {
+    return `${PATHS.WORKSPACE}/${developer}`;
+}
+/**
+ * Get task directory path
+ * @example getTaskDir("01-21-my-task") => ".trellis/tasks/01-21-my-task"
+ */
+export function getTaskDir(taskName) {
+    return `${PATHS.TASKS}/${taskName}`;
+}
+/**
+ * Get archive directory path
+ * @example getArchiveDir() => ".trellis/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;CACV,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,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"}