@blulotus/trellis 0.7.0

package/dist/configurators/snow.js

@@ -0,0 +1,69 @@
+/**
+ * Snow CLI configurator.
+ *
+ * Snow CLI is a class-1 platform (agentCapable + auto context inject +
+ * project agent discovery + beforeSubAgentStart), same capability class as
+ * Claude Code / OMP — host protocol differs, workflow surface matches.
+ *
+ * Output paths:
+ * - `.snow/skills/` — workflow + bundled skills (Claude Code Skills layout)
+ * - `.snow/commands/trellis-*.json` — custom prompt slash commands (no trellis-start)
+ * - `.snow/agents/` — project sub-agents (auto-discovered by Snow; primary path)
+ * - `.snow/hooks/` — inject hooks (session / user / beforeSubAgentStart)
+ * - `.snow/SNOW.md` — operator guide
+ *
+ * Modern Snow does NOT ship `.snow/sub-agents.trellis.json` (legacy merge
+ * fragment for older hosts without project-agent discovery).
+ *
+ * hasHooks=true → filterCommands drops `start`; SessionStart injects context.
+ * Agents are written without class-2 pull-based prelude (hook inject is primary).
+ */
+import { AI_TOOLS } from "../types/ai-tools.js";
+import { getAllAgents, getAllHooks, getSnowGuide, } from "../templates/snow/index.js";
+import { collectSkillTemplates, resolveAllAsSkills, resolveBundledSkills, resolveCommands, replacePythonCommandLiterals, } from "./shared.js";
+function buildSnowCommandJson(name, content) {
+    const description = name === "continue"
+        ? "Resume the current Trellis task at the right workflow phase."
+        : name === "finish-work"
+            ? "Wrap up the current Trellis session: archive tasks and record journal."
+            : `Trellis: ${name}`;
+    return (JSON.stringify({
+        type: "prompt",
+        description,
+        command: content,
+        location: "project",
+    }, null, 2) + "\n");
+}
+function collectSnowStaticFiles() {
+    const files = new Map();
+    for (const hook of getAllHooks()) {
+        files.set(`.snow/hooks/${hook.targetPath}`, hook.content);
+    }
+    files.set(".snow/SNOW.md", getSnowGuide());
+    return files;
+}
+/**
+ * The Snow CLI file set — written at init and diffed by `trellis update`.
+ */
+export function collectSnowTemplates() {
+    const config = AI_TOOLS.snow;
+    const ctx = config.templateContext;
+    const files = new Map();
+    // hasHooks=true → resolveAllAsSkills drops trellis-start.
+    for (const [filePath, content] of collectSkillTemplates(".snow/skills", resolveAllAsSkills(ctx), resolveBundledSkills(ctx))) {
+        files.set(filePath, content);
+    }
+    for (const cmd of resolveCommands(ctx)) {
+        const body = replacePythonCommandLiterals(cmd.content);
+        files.set(`.snow/commands/trellis-${cmd.name}.json`, buildSnowCommandJson(cmd.name, body));
+    }
+    // class-1: no applyPullBasedPreludeMarkdown (hook inject is primary)
+    for (const agent of getAllAgents()) {
+        files.set(`.snow/agents/${agent.name}.md`, agent.content);
+    }
+    for (const [filePath, content] of collectSnowStaticFiles()) {
+        files.set(filePath, content);
+    }
+    return files;
+}
+//# sourceMappingURL=snow.js.map

package/dist/configurators/snow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snow.js","sourceRoot":"","sources":["../../src/configurators/snow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,SAAS,oBAAoB,CAAC,IAAY,EAAE,OAAe;IACzD,MAAM,WAAW,GACf,IAAI,KAAK,UAAU;QACjB,CAAC,CAAC,8DAA8D;QAChE,CAAC,CAAC,IAAI,KAAK,aAAa;YACtB,CAAC,CAAC,wEAAwE;YAC1E,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;IAE3B,OAAO,CACL,IAAI,CAAC,SAAS,CACZ;QACE,IAAI,EAAE,QAAQ;QACd,WAAW;QACX,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,SAAS;KACpB,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,EAAE,CAAC;QACjC,KAAK,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,0DAA0D;IAC1D,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,qBAAqB,CACrD,cAAc,EACd,kBAAkB,CAAC,GAAG,CAAC,EACvB,oBAAoB,CAAC,GAAG,CAAC,CAC1B,EAAE,CAAC;QACF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,4BAA4B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CACP,0BAA0B,GAAG,CAAC,IAAI,OAAO,EACzC,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CACrC,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,EAAE,CAAC;QACnC,KAAK,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,sBAAsB,EAAE,EAAE,CAAC;QAC3D,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/configurators/trae.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The Trae IDE file set — written at init and diffed by `trellis update`.
+ *
+ * Trae is a class-2 platform: hooks fire on SessionStart + UserPromptSubmit in
+ * the main session, but cannot inject sub-agent prompts. Sub-agents use a
+ * pull-based prelude to load context themselves.
+ *
+ *   .trae/
+ *   ├── commands/      # Slash commands (trellis-*.md with frontmatter)
+ *   ├── skills/        # Skill definitions
+ *   ├── agents/        # Sub-agent definitions with pull-based prelude
+ *   ├── hooks/         # Shared Python hook scripts
+ *   └── hooks.json     # Hook event registration
+ */
+export declare function collectTraeTemplates(): Map<string, string>;
+//# sourceMappingURL=trae.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trae.d.ts","sourceRoot":"","sources":["../../src/configurators/trae.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsB1D"}

package/dist/configurators/trae.js

@@ -0,0 +1,34 @@
+import path from "node:path";
+import { AI_TOOLS } from "../types/ai-tools.js";
+import { resolvePlaceholders, wrapWithCommandFrontmatter, collectBothTemplates, collectSharedHooks, applyPullBasedPreludeMarkdown, } from "./shared.js";
+import { getAllAgents, getSettingsTemplate } from "../templates/trae/index.js";
+/**
+ * The Trae IDE file set — written at init and diffed by `trellis update`.
+ *
+ * Trae is a class-2 platform: hooks fire on SessionStart + UserPromptSubmit in
+ * the main session, but cannot inject sub-agent prompts. Sub-agents use a
+ * pull-based prelude to load context themselves.
+ *
+ *   .trae/
+ *   ├── commands/      # Slash commands (trellis-*.md with frontmatter)
+ *   ├── skills/        # Skill definitions
+ *   ├── agents/        # Sub-agent definitions with pull-based prelude
+ *   ├── hooks/         # Shared Python hook scripts
+ *   └── hooks.json     # Hook event registration
+ */
+export function collectTraeTemplates() {
+    const files = collectBothTemplates(AI_TOOLS.trae.templateContext, (n) => `.trae/commands/trellis-${n}.md`, ".trae/skills", (filePath, content) => {
+        const name = path.basename(filePath, ".md");
+        return wrapWithCommandFrontmatter(name, content);
+    });
+    for (const agent of applyPullBasedPreludeMarkdown(getAllAgents())) {
+        files.set(`.trae/agents/${agent.name}.md`, agent.content);
+    }
+    for (const [k, v] of collectSharedHooks(".trae/hooks", "trae")) {
+        files.set(k, v);
+    }
+    const settings = getSettingsTemplate();
+    files.set(`.trae/${settings.targetPath}`, resolvePlaceholders(settings.content));
+    return files;
+}
+//# sourceMappingURL=trae.js.map

package/dist/configurators/trae.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trae.js","sourceRoot":"","sources":["../../src/configurators/trae.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,oBAAoB,CAChC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,EACvC,cAAc,EACd,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5C,OAAO,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC,CACF,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,6BAA6B,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;QAClE,KAAK,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC;QAC/D,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,KAAK,CAAC,GAAG,CACP,SAAS,QAAQ,CAAC,UAAU,EAAE,EAC9B,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CACtC,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/configurators/workflow.d.ts

@@ -0,0 +1,51 @@
+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;
+}
+/**
+ * Ensure the project-root `.gitattributes` carries the journal `merge=union`
+ * rule, without ever overwriting a user's existing file wholesale.
+ *
+ * - No `.gitattributes` yet: write the bundled template directly.
+ * - Existing file that already has a `journal-*.md merge=union` rule (user's
+ *   own or from a previous `trellis init`/`update`): no-op, avoids duplicates.
+ * - Existing file without that rule: append the bundled template content.
+ *
+ * Intentionally does NOT go through the standard `writeFile` conflict-prompt
+ * flow — this file is additive-only and never a candidate for whole-file
+ * overwrite.
+ */
+export declare function ensureGitattributes(cwd: string): void;
+/**
+ * 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":"AAyCA,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;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAerD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAmEf"}

package/dist/configurators/workflow.js

@@ -0,0 +1,210 @@
+import fs from "node:fs";
+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, gitattributesTemplate, 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";
+/**
+ * Regex used to detect an existing `journal-*.md merge=union` gitattributes
+ * rule (any whitespace variant), so `ensureGitattributes` never appends a
+ * duplicate entry to a project's pre-existing `.gitattributes`.
+ */
+const JOURNAL_MERGE_UNION_PATTERN = /journal-\*\.md\s+merge=union/;
+/**
+ * Ensure the project-root `.gitattributes` carries the journal `merge=union`
+ * rule, without ever overwriting a user's existing file wholesale.
+ *
+ * - No `.gitattributes` yet: write the bundled template directly.
+ * - Existing file that already has a `journal-*.md merge=union` rule (user's
+ *   own or from a previous `trellis init`/`update`): no-op, avoids duplicates.
+ * - Existing file without that rule: append the bundled template content.
+ *
+ * Intentionally does NOT go through the standard `writeFile` conflict-prompt
+ * flow — this file is additive-only and never a candidate for whole-file
+ * overwrite.
+ */
+export function ensureGitattributes(cwd) {
+    const targetPath = path.join(cwd, ".gitattributes");
+    if (!fs.existsSync(targetPath)) {
+        fs.writeFileSync(targetPath, gitattributesTemplate);
+        return;
+    }
+    const existing = fs.readFileSync(targetPath, "utf-8");
+    if (JOURNAL_MERGE_UNION_PATTERN.test(existing)) {
+        return;
+    }
+    const separator = existing.endsWith("\n") ? "\n" : "\n\n";
+    fs.writeFileSync(targetPath, existing + separator + gitattributesTemplate);
+}
+/**
+ * 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);
+    // Ensure project-root .gitattributes carries the journal merge=union rule
+    // (additive-only — never overwrites a user's existing file wholesale).
+    ensureGitattributes(cwd);
+    // Dispatch channel runtime agent definitions. These are platform-agnostic
+    // Trellis runtime files consumed by `trellis 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 `trellis 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
+        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,23 @@
+/**
+ * ZCode configurator.
+ *
+ * ZCode (智谱) is an agentCapable class-1 platform. Since ZCode 3.x it exposes
+ * a workspace hook config at `.zcode/config.json` (SessionStart,
+ * UserPromptSubmit, and PreToolUse for Agent/Task), so `hasHooks` is true.
+ * Four output paths:
+ * - `.zcode/skills/` — ZCode-private workflow and bundled skills
+ * - `.zcode/commands/trellis/` — slash commands (invoked as /trellis:<name>)
+ * - `.zcode/agents/` — sub-agent definitions with hook-injection fallback
+ * - `.zcode/hooks/` + `.zcode/config.json` — shared Python hook scripts and
+ *   the workspace hook registration
+ */
+/**
+ * The ZCode file set — written at init and diffed by `trellis update`.
+ */
+export declare function collectZcodeTemplates(): Map<string, string>;
+/**
+ * Configure ZCode at init time: write the collected file set, then the one
+ * thing a `Map<path, content>` cannot carry — a console notice.
+ */
+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;;;;;;;;;;;;GAYG;AAiBH;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAqC3D;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/D"}

package/dist/configurators/zcode.js

@@ -0,0 +1,63 @@
+/**
+ * ZCode configurator.
+ *
+ * ZCode (智谱) is an agentCapable class-1 platform. Since ZCode 3.x it exposes
+ * a workspace hook config at `.zcode/config.json` (SessionStart,
+ * UserPromptSubmit, and PreToolUse for Agent/Task), so `hasHooks` is true.
+ * Four output paths:
+ * - `.zcode/skills/` — ZCode-private workflow and bundled skills
+ * - `.zcode/commands/trellis/` — slash commands (invoked as /trellis:<name>)
+ * - `.zcode/agents/` — sub-agent definitions with hook-injection fallback
+ * - `.zcode/hooks/` + `.zcode/config.json` — shared Python hook scripts and
+ *   the workspace hook registration
+ */
+import { AI_TOOLS } from "../types/ai-tools.js";
+import { getAllAgents, getHooksConfig } from "../templates/zcode/index.js";
+import { getSharedHookScriptsForPlatform } from "../templates/shared-hooks/index.js";
+import { collectSkillTemplates, resolveBundledSkills, resolveCommands, resolvePlaceholders, resolveSkills, writeTemplateMap, } from "./shared.js";
+/** Shared hooks directory written for ZCode (mirrors the configure path). */
+const ZCODE_HOOKS_DIR = ".zcode/hooks";
+/**
+ * The ZCode file set — written at init and diffed by `trellis update`.
+ */
+export function collectZcodeTemplates() {
+    const config = AI_TOOLS.zcode;
+    const ctx = config.templateContext;
+    const files = new Map();
+    // 1. ZCode-private workflow and bundled skills → .zcode/skills/.
+    for (const [filePath, content] of collectSkillTemplates(".zcode/skills", resolveSkills(ctx), resolveBundledSkills(ctx))) {
+        files.set(filePath, content);
+    }
+    // 2. Commands → .zcode/commands/trellis/
+    for (const cmd of resolveCommands(ctx)) {
+        files.set(`.zcode/commands/trellis/${cmd.name}.md`, cmd.content);
+    }
+    // 3. Sub-agents → .zcode/agents/ (hook-inject; templates carry fallback).
+    for (const agent of getAllAgents()) {
+        files.set(`.zcode/agents/${agent.name}.md`, agent.content);
+    }
+    // 4. Shared hook scripts → .zcode/hooks/.
+    //    Content is platform-independent (no placeholders), collected as-is.
+    for (const hook of getSharedHookScriptsForPlatform("zcode")) {
+        files.set(`${ZCODE_HOOKS_DIR}/${hook.name}`, hook.content);
+    }
+    // 5. Workspace hook registration → .zcode/config.json
+    files.set(".zcode/config.json", resolvePlaceholders(getHooksConfig().content));
+    return files;
+}
+/**
+ * Configure ZCode at init time: write the collected file set, then the one
+ * thing a `Map<path, content>` cannot carry — a console notice.
+ */
+export async function configureZcode(cwd) {
+    await writeTemplateMap(cwd, collectZcodeTemplates());
+    // ZCode loads hook config at session start and does NOT hot-reload it, so
+    // users must open a new session for these hooks to fire. Mirrors the Codex
+    // one-shot hint pattern; silent under test/quiet environments.
+    if (!process.env.VITEST && !process.env.TRELLIS_QUIET) {
+        process.stderr.write("ℹ️  ZCode loads hooks at session start (no hot-reload). " +
+            "Open a NEW ZCode session for the Trellis SessionStart / " +
+            "UserPromptSubmit / PreToolUse hooks in .zcode/config.json to take effect.\n");
+    }
+}
+//# 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;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,MAAM,eAAe,GAAG,cAAc,CAAC;AAEvC;;GAEG;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,iEAAiE;IACjE,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,qBAAqB,CACrD,eAAe,EACf,aAAa,CAAC,GAAG,CAAC,EAClB,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,0EAA0E;IAC1E,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,EAAE,CAAC;QACnC,KAAK,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,IAAI,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,0CAA0C;IAC1C,yEAAyE;IACzE,KAAK,MAAM,IAAI,IAAI,+BAA+B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,KAAK,CAAC,GAAG,CAAC,GAAG,eAAe,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,GAAG,CACP,oBAAoB,EACpB,mBAAmB,CAAC,cAAc,EAAE,CAAC,OAAO,CAAC,CAC9C,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,gBAAgB,CAAC,GAAG,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAErD,0EAA0E;IAC1E,2EAA2E;IAC3E,+DAA+D;IAC/D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0DAA0D;YACxD,0DAA0D;YAC1D,6EAA6E,CAChF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/constants/paths.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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";
+    /** Channel runtime agent definitions (under .trellis/) */
+    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: {
+    /** .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/agents/ */
+    readonly AGENTS: ".trellis/agents";
+    /** .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;;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"}