first-tree 0.0.3 → 0.0.5

package/skills/first-tree/tests/skill-artifacts.test.ts

@@ -22,6 +22,7 @@ describe("skill artifacts", () => {
     expect(existsSync(join(ROOT, "skills", "first-tree", "references", "onboarding.md"))).toBe(true);
     expect(existsSync(join(ROOT, "skills", "first-tree", "assets", "framework", "manifest.json"))).toBe(true);
     expect(existsSync(join(ROOT, "skills", "first-tree", "engine", "init.ts"))).toBe(true);
+    expect(existsSync(join(ROOT, "AGENTS.md"))).toBe(true);
     expect(existsSync(join(ROOT, "skills", "first-tree", "tests", "init.test.ts"))).toBe(
       true,
     );
@@ -114,6 +115,7 @@ describe("skill artifacts", () => {
     expect(isTrackedInGit(".agents")).toBe(false);
     expect(isTrackedInGit(".claude")).toBe(false);
     expect(isTrackedInGit(".context-tree")).toBe(false);
+    expect(existsSync(join(ROOT, "AGENT.md"))).toBe(false);
     expect(isTrackedInGit("skills/first-tree-cli-framework")).toBe(false);
     expect(isTrackedInGit("docs")).toBe(false);
     expect(isTrackedInGit("tests")).toBe(false);
@@ -199,7 +201,10 @@ describe("skill artifacts", () => {
     expect(read("README.md")).toContain("Canonical Documentation");
     expect(read("README.md")).toContain("references/source-map.md");
     expect(read("README.md")).toContain("skills/first-tree/");
+    expect(read("README.md")).toContain(".agents/skills/first-tree/");
+    expect(read("README.md")).toContain(".claude/skills/first-tree/");
     expect(read("README.md")).toContain("bundled canonical");
+    expect(read("README.md")).toContain("dedicated tree repo");
     expect(read("README.md")).toContain("`first-tree` skill");
     expect(read("AGENTS.md")).toContain("references/source-map.md");
     expect(read("AGENTS.md")).toContain("bundled skill path");
@@ -211,9 +216,12 @@ describe("skill artifacts", () => {
     const onboarding = read("skills/first-tree/references/onboarding.md");
     expect(onboarding).toContain("npx first-tree init");
     expect(onboarding).toContain("npm install -g first-tree");
+    expect(onboarding).toContain("context-tree init --here");
     expect(onboarding).toContain("installed CLI command is");
     expect(onboarding).toContain("currently running `first-tree` npm package");
     expect(onboarding).toContain("npx first-tree@latest upgrade");
+    expect(onboarding).toContain(".agents/skills/first-tree/");
+    expect(onboarding).toContain(".claude/skills/first-tree/");
     expect(onboarding).not.toContain("This clones the framework into `.context-tree/`");
     expect(onboarding).not.toContain("from upstream");
 
@@ -224,6 +232,8 @@ describe("skill artifacts", () => {
     expect(skillMd).toContain("maintainer-testing.md");
     expect(skillMd).toContain("currently running `first-tree` package");
     expect(skillMd).toContain("so it is not confused with the `first-tree`");
+    expect(skillMd).toContain(".agents/skills/first-tree/");
+    expect(skillMd).toContain(".claude/skills/first-tree/");
     expect(skillMd).not.toContain("canonical eval harness");
 
     const sourceMap = read("skills/first-tree/references/source-map.md");

package/skills/first-tree/tests/thin-cli.test.ts

@@ -1,9 +1,17 @@
-import { readFileSync } from "node:fs";
+import {
+  mkdtempSync,
+  readFileSync,
+  rmSync,
+  symlinkSync,
+  writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { describe, expect, it } from "vitest";
-import { USAGE, runCli } from "../../../src/cli.ts";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { afterEach, describe, expect, it } from "vitest";
+import { USAGE, isDirectExecution, runCli } from "../../../src/cli.ts";
 
-const ROOT = process.cwd();
+const TEMP_DIRS: string[] = [];
 
 function captureOutput(): { lines: string[]; write: (text: string) => void } {
   const lines: string[] = [];
@@ -15,7 +23,45 @@ function captureOutput(): { lines: string[]; write: (text: string) => void } {
   };
 }
 
+function makeTempDir(): string {
+  const dir = mkdtempSync(join(tmpdir(), "first-tree-thin-cli-"));
+  TEMP_DIRS.push(dir);
+  return dir;
+}
+
+afterEach(() => {
+  while (TEMP_DIRS.length > 0) {
+    const dir = TEMP_DIRS.pop();
+    if (dir) {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  }
+});
+
 describe("thin CLI shell", () => {
+  it("treats a symlinked npm bin path as direct execution", () => {
+    const dir = makeTempDir();
+    const target = join(dir, "cli.js");
+    const symlinkPath = join(dir, "context-tree");
+
+    writeFileSync(target, "#!/usr/bin/env node\n");
+    symlinkSync(target, symlinkPath);
+
+    expect(isDirectExecution(symlinkPath, pathToFileURL(target).href)).toBe(true);
+  });
+
+  it("does not treat unrelated argv[1] values as direct execution", () => {
+    const dir = makeTempDir();
+    const target = join(dir, "cli.js");
+    const other = join(dir, "other.js");
+
+    writeFileSync(target, "#!/usr/bin/env node\n");
+    writeFileSync(other, "#!/usr/bin/env node\n");
+
+    expect(isDirectExecution(other, pathToFileURL(target).href)).toBe(false);
+    expect(isDirectExecution(undefined, pathToFileURL(target).href)).toBe(false);
+  });
+
   it("prints usage with no args", async () => {
     const output = captureOutput();
 
@@ -27,9 +73,8 @@ describe("thin CLI shell", () => {
 
   it("prints the package version", async () => {
     const output = captureOutput();
-    const pkg = JSON.parse(readFileSync(join(ROOT, "package.json"), "utf-8")) as {
-      version: string;
-    };
+    const pkgPath = fileURLToPath(new URL("../../../package.json", import.meta.url));
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8")) as { version: string };
 
     const code = await runCli(["--version"], output.write);
 

package/skills/first-tree/tests/upgrade.test.ts

@@ -1,15 +1,20 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { describe, expect, it } from "vitest";
 import { Repo } from "#skill/engine/repo.js";
 import { runUpgrade } from "#skill/engine/upgrade.js";
 import {
+  AGENT_INSTRUCTIONS_FILE,
   FRAMEWORK_VERSION,
   INSTALLED_PROGRESS,
+  LEGACY_AGENT_INSTRUCTIONS_FILE,
 } from "#skill/engine/runtime/asset-loader.js";
 import {
+  makeAgentsMd,
   makeFramework,
+  makeSourceRepo,
   makeLegacyFramework,
+  makeLegacyRepoFramework,
   makeLegacyNamedFramework,
   makeSourceSkill,
   useTmpDir,
@@ -20,10 +25,7 @@ describe("runUpgrade", () => {
     const repoDir = useTmpDir();
     const sourceDir = useTmpDir();
     makeLegacyFramework(repoDir.path, "0.1.0");
-    writeFileSync(
-      join(repoDir.path, "AGENT.md"),
-      "<!-- BEGIN CONTEXT-TREE FRAMEWORK -->\nstuff\n<!-- END CONTEXT-TREE FRAMEWORK -->\n",
-    );
+    makeAgentsMd(repoDir.path, { legacyName: true, markers: true, userContent: true });
     makeSourceSkill(sourceDir.path, "0.2.0");
 
     const result = runUpgrade(new Repo(repoDir.path), {
@@ -34,7 +36,13 @@ describe("runUpgrade", () => {
     expect(existsSync(join(repoDir.path, ".context-tree"))).toBe(false);
     expect(readFileSync(join(repoDir.path, FRAMEWORK_VERSION), "utf-8").trim()).toBe("0.2.0");
     expect(readFileSync(join(repoDir.path, INSTALLED_PROGRESS), "utf-8")).toContain(
-      "skills/first-tree/assets/framework/VERSION",
+      ".agents/skills/first-tree/assets/framework/VERSION",
+    );
+    expect(readFileSync(join(repoDir.path, INSTALLED_PROGRESS), "utf-8")).toContain(
+      `Rename \`${LEGACY_AGENT_INSTRUCTIONS_FILE}\` to \`${AGENT_INSTRUCTIONS_FILE}\``,
+    );
+    expect(readFileSync(join(repoDir.path, INSTALLED_PROGRESS), "utf-8")).toContain(
+      "skills/first-tree/assets/framework/templates/agents.md.template",
     );
   });
 
@@ -72,6 +80,24 @@ describe("runUpgrade", () => {
     );
   });
 
+  it("migrates repos that still use the previous workspace skill path", () => {
+    const repoDir = useTmpDir();
+    const sourceDir = useTmpDir();
+    makeLegacyRepoFramework(repoDir.path, "0.1.0");
+    makeSourceSkill(sourceDir.path, "0.2.0");
+
+    const result = runUpgrade(new Repo(repoDir.path), {
+      sourceRoot: sourceDir.path,
+    });
+
+    expect(result).toBe(0);
+    expect(existsSync(join(repoDir.path, "skills", "first-tree"))).toBe(false);
+    expect(readFileSync(join(repoDir.path, FRAMEWORK_VERSION), "utf-8").trim()).toBe("0.2.0");
+    expect(readFileSync(join(repoDir.path, INSTALLED_PROGRESS), "utf-8")).toContain(
+      "skills/first-tree/",
+    );
+  });
+
   it("refuses to replace a newer installed skill with an older packaged skill", () => {
     const repoDir = useTmpDir();
     const sourceDir = useTmpDir();
@@ -86,4 +112,11 @@ describe("runUpgrade", () => {
     expect(readFileSync(join(repoDir.path, FRAMEWORK_VERSION), "utf-8").trim()).toBe("0.3.0");
     expect(existsSync(join(repoDir.path, INSTALLED_PROGRESS))).toBe(false);
   });
+
+  it("gives a dedicated-tree hint when run from a source repo", () => {
+    const repoDir = useTmpDir();
+    makeSourceRepo(repoDir.path);
+    const result = runUpgrade(new Repo(repoDir.path));
+    expect(result).toBe(1);
+  });
 });

package/skills/first-tree/tests/verify.test.ts

@@ -1,19 +1,23 @@
-import { mkdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { describe, expect, it } from "vitest";
+import { runInit } from "#skill/engine/init.js";
 import { check, checkProgress, runVerify } from "#skill/engine/verify.js";
 import { Repo } from "#skill/engine/repo.js";
 import {
+  AGENT_INSTRUCTIONS_FILE,
   INSTALLED_PROGRESS,
   LEGACY_PROGRESS,
 } from "#skill/engine/runtime/asset-loader.js";
 import {
   useTmpDir,
+  makeAgentsMd,
   makeFramework,
   makeLegacyFramework,
   makeNode,
-  makeAgentMd,
+  makeSourceRepo,
   makeMembers,
+  makeSourceSkill,
 } from "./helpers.js";
 
 // --- check ---
@@ -39,7 +43,7 @@ describe("checkProgress", () => {
 
   it("returns empty when all checked", () => {
     const tmp = useTmpDir();
-    mkdirSync(join(tmp.path, "skills", "first-tree"), { recursive: true });
+    makeFramework(tmp.path);
     writeFileSync(
       join(tmp.path, INSTALLED_PROGRESS),
       "# Progress\n- [x] Task one\n- [x] Task two\n",
@@ -50,7 +54,7 @@ describe("checkProgress", () => {
 
   it("returns unchecked items", () => {
     const tmp = useTmpDir();
-    mkdirSync(join(tmp.path, "skills", "first-tree"), { recursive: true });
+    makeFramework(tmp.path);
     writeFileSync(
       join(tmp.path, INSTALLED_PROGRESS),
       "# Progress\n- [x] Done task\n- [ ] Pending task\n- [ ] Another pending\n",
@@ -61,7 +65,7 @@ describe("checkProgress", () => {
 
   it("returns empty for empty progress", () => {
     const tmp = useTmpDir();
-    mkdirSync(join(tmp.path, "skills", "first-tree"), { recursive: true });
+    makeFramework(tmp.path);
     writeFileSync(join(tmp.path, INSTALLED_PROGRESS), "");
     const repo = new Repo(tmp.path);
     expect(checkProgress(repo)).toEqual([]);
@@ -88,10 +92,7 @@ function buildFullRepo(root: string): void {
     join(root, "NODE.md"),
     "---\ntitle: My Org\nowners: [alice]\n---\n# Content\n",
   );
-  writeFileSync(
-    join(root, "AGENT.md"),
-    "<!-- BEGIN CONTEXT-TREE FRAMEWORK -->\nstuff\n<!-- END CONTEXT-TREE FRAMEWORK -->\n",
-  );
+  makeAgentsMd(root, { markers: true });
   makeMembers(root, 1);
 }
 
@@ -108,6 +109,74 @@ describe("runVerify all passing", () => {
     const ret = runVerify(repo, passValidator);
     expect(ret).toBe(0);
   });
+
+  it("passes after a real init flow when only the user tree remains to validate", () => {
+    const repoDir = useTmpDir();
+    const sourceDir = useTmpDir();
+    mkdirSync(join(repoDir.path, ".git"));
+    makeSourceSkill(sourceDir.path, "0.2.0");
+
+    expect(runInit(new Repo(repoDir.path), { sourceRoot: sourceDir.path })).toBe(0);
+
+    writeFileSync(
+      join(repoDir.path, "NODE.md"),
+      [
+        "---",
+        'title: "Example Tree"',
+        "owners: [alice]",
+        "---",
+        "",
+        "# Example Tree",
+        "",
+        "A repository initialized from the bundled skill for verification coverage.",
+        "",
+        "## Domains",
+        "",
+        "- **[members/](members/NODE.md)** — Team member definitions and responsibilities.",
+        "",
+      ].join("\n"),
+    );
+
+    const agentPath = join(repoDir.path, AGENT_INSTRUCTIONS_FILE);
+    writeFileSync(
+      agentPath,
+      `${readFileSync(agentPath, "utf-8").trim()}\n\nProject-specific verification instructions.\n`,
+    );
+
+    mkdirSync(join(repoDir.path, "members", "alice"), { recursive: true });
+    writeFileSync(
+      join(repoDir.path, "members", "alice", "NODE.md"),
+      [
+        "---",
+        'title: "Alice"',
+        "owners: [alice]",
+        'type: "human"',
+        'role: "Maintainer"',
+        "domains:",
+        '  - "members"',
+        "---",
+        "",
+        "# Alice",
+        "",
+        "## About",
+        "",
+        "Maintains the initialized tree and keeps the docs current.",
+        "",
+        "## Current Focus",
+        "",
+        "Validating the init-to-verify workflow.",
+        "",
+      ].join("\n"),
+    );
+
+    const progressPath = join(repoDir.path, INSTALLED_PROGRESS);
+    writeFileSync(
+      progressPath,
+      readFileSync(progressPath, "utf-8").replace(/^- \[ \]/gm, "- [x]"),
+    );
+
+    expect(runVerify(new Repo(repoDir.path))).toBe(0);
+  });
 });
 
 // --- runVerify — failing checks ---
@@ -120,7 +189,7 @@ describe("runVerify failing", () => {
     expect(ret).toBe(1);
   });
 
-  it("fails when AGENT.md is missing", () => {
+  it("fails when AGENTS.md is missing", () => {
     const tmp = useTmpDir();
     makeFramework(tmp.path);
     writeFileSync(
@@ -132,6 +201,28 @@ describe("runVerify failing", () => {
     expect(ret).toBe(1);
   });
 
+  it("fails when only legacy AGENT.md exists", () => {
+    const tmp = useTmpDir();
+    mkdirSync(join(tmp.path, ".git"));
+    makeFramework(tmp.path);
+    makeNode(tmp.path);
+    makeAgentsMd(tmp.path, { legacyName: true, markers: true, userContent: true });
+    makeMembers(tmp.path, 1);
+    const repo = new Repo(tmp.path);
+    const ret = runVerify(repo, passValidator);
+    expect(existsSync(join(tmp.path, AGENT_INSTRUCTIONS_FILE))).toBe(false);
+    expect(ret).toBe(1);
+  });
+
+  it("fails when legacy AGENT.md remains alongside AGENTS.md", () => {
+    const tmp = useTmpDir();
+    buildFullRepo(tmp.path);
+    makeAgentsMd(tmp.path, { legacyName: true, markers: true, userContent: true });
+    const repo = new Repo(tmp.path);
+    const ret = runVerify(repo, passValidator);
+    expect(ret).toBe(1);
+  });
+
   it("fails when node validation returns non-zero", () => {
     const tmp = useTmpDir();
     buildFullRepo(tmp.path);
@@ -139,4 +230,12 @@ describe("runVerify failing", () => {
     const ret = runVerify(repo, failValidator);
     expect(ret).toBe(1);
   });
+
+  it("gives a dedicated-tree hint when run from a source repo", () => {
+    const tmp = useTmpDir();
+    makeSourceRepo(tmp.path);
+    const repo = new Repo(tmp.path);
+    const ret = runVerify(repo, passValidator);
+    expect(ret).toBe(1);
+  });
 });

package/dist/onboarding-6Fr5Gkrk.js

@@ -1,2 +0,0 @@
-import { t as runOnboarding } from "./onboarding-B9zPGvvG.js";
-export { runOnboarding };

package/dist/onboarding-B9zPGvvG.js

@@ -1,10 +0,0 @@
-//#region skills/first-tree/references/onboarding.md
-var onboarding_default = "# Context Tree Onboarding\n\nYou are setting up a **Context Tree** — the living source of truth for an organization. This document tells you what it is and how to bootstrap one.\n\n---\n\n## What Is a Context Tree\n\nA Context Tree is a Git repository where every directory is a **domain** and every file is a **node**. Each node captures decisions, designs, and cross-domain relationships — the knowledge that would otherwise scatter across PRs, documents, and people's heads.\n\nKey properties:\n\n- **Nodes are markdown files.** Each directory has a `NODE.md` that describes the domain. Leaf `.md` files capture specific decisions or designs.\n- **Every node has an owner.** Declared in YAML frontmatter. Owners approve changes to their nodes.\n- **Organized by concern, not by repo or team.** An agent working on \"add SSO\" finds all auth context in one place — not split across 4 repos.\n- **The tree is never a snapshot — it's the current state.** When decisions change, the tree updates. Stale nodes are bugs.\n\n### Frontmatter Format\n\nEvery node has frontmatter:\n\n```yaml\n---\ntitle: \"Auth Architecture\"\nowners: [alice, bob]\nsoft_links: [/infrastructure/deployments]\n---\n```\n\n- `owners` — who can approve changes. `owners: []` inherits from parent. `owners: [*]` means anyone.\n- `soft_links` — cross-references to related nodes in other domains.\n\n### What Belongs in the Tree\n\nInformation an agent needs to **decide** on an approach — not to execute it.\n\n**Yes:** \"Auth spans 4 repos: backend issues JWTs, frontend uses Better Auth, extension uses OAuth popup, desktop uses localhost callback.\"\n\n**No:** The function signature of `auth_service.verify()` — that's in the code.\n\n---\n\n## Four Principles\n\n1. **Source of truth for decisions, not execution.** The tree captures the *what* and *why*. Execution details stay in source systems.\n2. **Agents are first-class participants.** The tree is designed for agents to navigate and update.\n3. **Transparency by default.** Reading is open to all. Writing requires owner approval.\n4. **Git-native.** Nodes are files, domains are directories. History, ownership, and review follow Git conventions.\n\n---\n\n## How to Set Up a Context Tree\n\n### Prerequisites\n\n- A Git repository for your tree (separate from your code repos)\n- Node.js 18+\n- The npm package is `first-tree`, the installed CLI command is\n  `context-tree`, and the installed skill directory in the tree is\n  `skills/first-tree/`\n- Use `npx first-tree init` for one-off runs, or `npm install -g first-tree`\n  to add the `context-tree` command to your PATH\n\n### Step 1: Initialize\n\n```bash\nmkdir my-org-tree && cd my-org-tree\ngit init\ncontext-tree init\n```\n\nThis installs the framework skill into `skills/first-tree/`, renders scaffolding (`NODE.md`, `AGENT.md`, `members/NODE.md`), and generates a task list in `skills/first-tree/progress.md`.\n\n### Step 2: Work Through the Task List\n\nRead `skills/first-tree/progress.md`. It contains a checklist tailored to the current state of the repo. Complete each task:\n\n- Fill in `NODE.md` with your organization name, owners, and domains\n- Add project-specific instructions to `AGENT.md` below the framework markers\n- Create member nodes under `members/`\n- Optionally configure agent integration (e.g., Claude Code session hooks)\n- Copy validation workflows from `skills/first-tree/assets/framework/workflows/` to `.github/workflows/`\n\nAs you complete each task, check it off in `skills/first-tree/progress.md` by changing `- [ ]` to `- [x]`.\n\n### Step 3: Verify\n\n```bash\ncontext-tree verify\n```\n\nThis fails if any items in `skills/first-tree/progress.md` remain unchecked, and runs deterministic checks (valid frontmatter, node structure, member nodes exist).\n\n### Step 4: Design Your Domains\n\nCreate top-level directories for your organization's primary concerns. Each needs a `NODE.md`:\n\n```\nmy-org-tree/\n  NODE.md              # root — lists all domains\n  engineering/\n    NODE.md            # decisions about architecture, infra, tooling\n  product/\n    NODE.md            # strategy, roadmap, user research\n  marketing/\n    NODE.md            # positioning, campaigns\n  members/\n    NODE.md            # team members and agents\n    alice/\n      NODE.md          # individual member node\n```\n\n### Step 5: Populate from Existing Work\n\nFor each domain, extract knowledge from existing repos, docs, and systems:\n\n- Decisions and their rationale\n- Cross-domain relationships and dependencies\n- Constraints that aren't obvious from the code\n\nThe tree doesn't duplicate source code — it captures what connects things and why they were built that way.\n\n---\n\n## CLI Reference\n\n| Command | Description |\n|---------|-------------|\n| `context-tree init` | Bootstrap a new tree. Installs the framework skill, renders templates, generates a task list. |\n| `context-tree verify` | Check the installed progress file for unchecked items + run deterministic validation. |\n| `context-tree upgrade` | Refresh the installed framework skill from the currently running `first-tree` npm package and generate follow-up tasks. |\n| `context-tree help onboarding` | Print this onboarding guide. |\n\n---\n\n## Upgrading the Framework\n\nWhen the framework updates:\n\n```bash\ncontext-tree upgrade\n```\n\n`context-tree upgrade` refreshes `skills/first-tree/` from the\nskill bundled with the currently running `first-tree` npm package, preserves your\ntree content, and generates follow-up tasks in\n`skills/first-tree/progress.md`.\n\nIf your repo still uses the older `skills/first-tree-cli-framework/` path,\n`context-tree upgrade` will migrate it to `skills/first-tree/` first.\n\nTo pick up a newer framework release, first run a newer package version, for\nexample `npx first-tree@latest upgrade`, or update your global `first-tree`\ninstall before running `context-tree upgrade`.\n\n---\n\n## Further Reading\n\n- `skills/first-tree/references/principles.md` — Core principles with detailed examples\n- `skills/first-tree/references/ownership-and-naming.md` — How nodes are named and owned\n- `AGENT.md` in your tree — The before/during/after workflow for every task\n";
-//#endregion
-//#region skills/first-tree/engine/onboarding.ts
-function runOnboarding(output = console.log) {
-	output(onboarding_default);
-	return 0;
-}
-//#endregion
-export { onboarding_default as n, runOnboarding as t };

package/dist/repo-BTJG8BU1.js

@@ -1,187 +0,0 @@
-import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { join, resolve } from "node:path";
-const SKILL_ROOT = join("skills", "first-tree");
-join(SKILL_ROOT, "agents");
-join(SKILL_ROOT, "references");
-const FRAMEWORK_ASSET_ROOT = join(SKILL_ROOT, "assets", "framework");
-join(FRAMEWORK_ASSET_ROOT, "manifest.json");
-const FRAMEWORK_VERSION = join(FRAMEWORK_ASSET_ROOT, "VERSION");
-const FRAMEWORK_TEMPLATES_DIR = join(FRAMEWORK_ASSET_ROOT, "templates");
-const FRAMEWORK_WORKFLOWS_DIR = join(FRAMEWORK_ASSET_ROOT, "workflows");
-join(FRAMEWORK_ASSET_ROOT, "prompts");
-const FRAMEWORK_EXAMPLES_DIR = join(FRAMEWORK_ASSET_ROOT, "examples");
-join(FRAMEWORK_ASSET_ROOT, "helpers");
-const INSTALLED_PROGRESS = join(SKILL_ROOT, "progress.md");
-const LEGACY_SKILL_ROOT = join("skills", "first-tree-cli-framework");
-const LEGACY_SKILL_ASSET_ROOT = join(LEGACY_SKILL_ROOT, "assets", "framework");
-const LEGACY_SKILL_VERSION = join(LEGACY_SKILL_ASSET_ROOT, "VERSION");
-join(LEGACY_SKILL_ASSET_ROOT, "templates");
-join(LEGACY_SKILL_ASSET_ROOT, "workflows");
-join(LEGACY_SKILL_ASSET_ROOT, "prompts");
-join(LEGACY_SKILL_ASSET_ROOT, "examples");
-const LEGACY_SKILL_PROGRESS = join(LEGACY_SKILL_ROOT, "progress.md");
-const LEGACY_FRAMEWORK_ROOT = ".context-tree";
-const LEGACY_VERSION = join(LEGACY_FRAMEWORK_ROOT, "VERSION");
-const LEGACY_PROGRESS = join(LEGACY_FRAMEWORK_ROOT, "progress.md");
-join(LEGACY_FRAMEWORK_ROOT, "templates");
-join(LEGACY_FRAMEWORK_ROOT, "workflows");
-join(LEGACY_FRAMEWORK_ROOT, "prompts");
-join(LEGACY_FRAMEWORK_ROOT, "examples");
-function pathExists(root, relPath) {
-	const fullPath = join(root, relPath);
-	try {
-		return existsSync(fullPath);
-	} catch {
-		return false;
-	}
-}
-function frameworkVersionCandidates() {
-	return [
-		FRAMEWORK_VERSION,
-		LEGACY_SKILL_VERSION,
-		LEGACY_VERSION
-	];
-}
-function progressFileCandidates() {
-	return [
-		INSTALLED_PROGRESS,
-		LEGACY_SKILL_PROGRESS,
-		LEGACY_PROGRESS
-	];
-}
-function resolveFirstExistingPath(root, candidates) {
-	for (const candidate of candidates) if (pathExists(root, candidate)) return candidate;
-	return null;
-}
-function detectFrameworkLayout(root) {
-	if (pathExists(root, FRAMEWORK_VERSION)) return "skill";
-	if (pathExists(root, LEGACY_SKILL_VERSION)) return "legacy-skill";
-	if (pathExists(root, LEGACY_VERSION)) return "legacy";
-	return null;
-}
-//#endregion
-//#region skills/first-tree/engine/repo.ts
-const FRONTMATTER_RE = /^---\s*\n(.*?)\n---/s;
-const OWNERS_RE = /^owners:\s*\[([^\]]*)\]/m;
-const TITLE_RE = /^title:\s*['"]?(.+?)['"]?\s*$/m;
-const FRAMEWORK_END_MARKER = "<!-- END CONTEXT-TREE FRAMEWORK -->";
-var Repo = class {
-	root;
-	constructor(root) {
-		this.root = resolve(root ?? process.cwd());
-	}
-	pathExists(relPath) {
-		return existsSync(join(this.root, relPath));
-	}
-	fileContains(relPath, text) {
-		const fullPath = join(this.root, relPath);
-		try {
-			if (!statSync(fullPath).isFile()) return false;
-			return readFileSync(fullPath, "utf-8").includes(text);
-		} catch {
-			return false;
-		}
-	}
-	readFile(relPath) {
-		try {
-			return readFileSync(join(this.root, relPath), "utf-8");
-		} catch {
-			return null;
-		}
-	}
-	frontmatter(relPath) {
-		const text = this.readFile(relPath);
-		if (text === null) return null;
-		const m = text.match(FRONTMATTER_RE);
-		if (!m) return null;
-		const fm = m[1];
-		const result = {};
-		const titleM = fm.match(TITLE_RE);
-		if (titleM) result.title = titleM[1].trim();
-		const ownersM = fm.match(OWNERS_RE);
-		if (ownersM) {
-			const raw = ownersM[1].trim();
-			result.owners = raw ? raw.split(",").map((o) => o.trim()).filter(Boolean) : [];
-		}
-		return result.title !== void 0 || result.owners !== void 0 ? result : null;
-	}
-	anyAgentConfig() {
-		return [".claude/settings.json", ".codex/config.json"].some((c) => this.pathExists(c));
-	}
-	isGitRepo() {
-		try {
-			return statSync(join(this.root, ".git")).isDirectory();
-		} catch {
-			return false;
-		}
-	}
-	hasFramework() {
-		return this.frameworkLayout() !== null;
-	}
-	frameworkLayout() {
-		return detectFrameworkLayout(this.root);
-	}
-	readVersion() {
-		const versionPath = resolveFirstExistingPath(this.root, frameworkVersionCandidates());
-		if (versionPath === null) return null;
-		const text = this.readFile(versionPath);
-		return text ? text.trim() : null;
-	}
-	progressPath() {
-		return resolveFirstExistingPath(this.root, progressFileCandidates());
-	}
-	preferredProgressPath() {
-		const layout = this.frameworkLayout();
-		if (layout === "legacy") return LEGACY_PROGRESS;
-		if (layout === "legacy-skill") return LEGACY_SKILL_PROGRESS;
-		return INSTALLED_PROGRESS;
-	}
-	frameworkVersionPath() {
-		const layout = this.frameworkLayout();
-		if (layout === "legacy") return LEGACY_VERSION;
-		if (layout === "legacy-skill") return LEGACY_SKILL_VERSION;
-		return FRAMEWORK_VERSION;
-	}
-	hasAgentMdMarkers() {
-		const text = this.readFile("AGENT.md");
-		if (text === null) return false;
-		return text.includes("<!-- BEGIN CONTEXT-TREE FRAMEWORK") && text.includes("<!-- END CONTEXT-TREE FRAMEWORK -->");
-	}
-	hasMembers() {
-		const membersDir = join(this.root, "members");
-		try {
-			if (!statSync(membersDir).isDirectory()) return false;
-		} catch {
-			return false;
-		}
-		return existsSync(join(membersDir, "NODE.md"));
-	}
-	memberCount() {
-		const membersDir = join(this.root, "members");
-		try {
-			if (!statSync(membersDir).isDirectory()) return 0;
-		} catch {
-			return 0;
-		}
-		let count = 0;
-		const walk = (dir) => {
-			for (const entry of readdirSync(dir)) {
-				const childPath = join(dir, entry);
-				try {
-					if (!statSync(childPath).isDirectory()) continue;
-				} catch {
-					continue;
-				}
-				if (existsSync(join(childPath, "NODE.md"))) count++;
-				walk(childPath);
-			}
-		};
-		walk(membersDir);
-		return count;
-	}
-	hasPlaceholderNode() {
-		return this.fileContains("NODE.md", "<!-- PLACEHOLDER");
-	}
-};
-//#endregion
-export { FRAMEWORK_TEMPLATES_DIR as a, INSTALLED_PROGRESS as c, SKILL_ROOT as d, FRAMEWORK_EXAMPLES_DIR as i, LEGACY_FRAMEWORK_ROOT as l, Repo as n, FRAMEWORK_VERSION as o, FRAMEWORK_ASSET_ROOT as r, FRAMEWORK_WORKFLOWS_DIR as s, FRAMEWORK_END_MARKER as t, LEGACY_SKILL_ROOT as u };