@first-tree-ai/context-tree 0.1.9 → 0.1.10

package/README.md

@@ -53,9 +53,9 @@ for an agent that is not present; uninstall removes every owned-prefix directory
 and nothing else. Adding support for another agent is one entry in the host table
 in `src/core/install.ts`.
 
-Once a project is connected, `create` and `connect` record the tree in the
-project's own `AGENTS.md`, so any agent that reads instruction files knows the
-tree exists without host-specific configuration.
+`create` and `connect` leave project instructions unchanged. When a project has
+a regular `AGENTS.md` and no `CLAUDE.md` entry, they best-effort create a
+`CLAUDE.md` symlink to `AGENTS.md`. Connections are stored separately.
 
 ## Six skills
 

package/dist/cli/index.mjs

@@ -7418,23 +7418,15 @@ object({
 	schemaVersion: literal(1),
 	tree: contextTreeStateSchema
 }).strict();
-/** Whether the project's AGENTS.md pointer was created, rewritten, or left alone. */
-const projectPointerOutcomeSchema = _enum([
-	"written",
-	"updated",
-	"skipped"
-]);
 object({
 	branch: string$2().trim().min(1),
 	commitSha: string$2(),
 	created: boolean(),
-	pointer: projectPointerOutcomeSchema,
 	schemaVersion: literal(1),
 	title: string$2().trim().min(1),
 	treePath: absoluteSingleLinePathSchema
 }).strict();
 object({
-	pointer: projectPointerOutcomeSchema,
 	schemaVersion: literal(1),
 	tree: contextTreeStateSchema
 }).strict();
@@ -7625,66 +7617,13 @@ function canonicalProjectRoot(path, runner) {
 	return realpathSync(toplevel);
 }
 //#endregion
-//#region src/core/internal/project-pointer.ts
-const BEGIN = "<!-- context-tree:begin -->";
-const END = "<!-- context-tree:end -->";
-function pointerBlock(treePath) {
-	return [
-		BEGIN,
-		"## Context Tree",
-		"",
-		`This project is connected to a Context Tree at \`${treePath}\`.`,
-		"",
-		"Read the decisions and constraints that bear on a task before planning or",
-		"changing code, and record durable decisions there. Use the `context-tree-read`",
-		"and `context-tree-write` skills rather than editing the tree by hand.",
-		END
-	].join("\n");
-}
-/** A real regular file, a real absent path, or a refusal. */
-function regularFileContent(path) {
-	const entry = lstatSync(path, { throwIfNoEntry: false });
-	if (entry === void 0) return void 0;
-	if (entry.isSymbolicLink() || !entry.isFile()) throw new Error(`Refusing to write the Context Tree pointer through a symlink or non-file: ${path}`);
-	return readFileSync(path, "utf8");
-}
-/**
-* Record the connected tree in the project's own `AGENTS.md`, so any agent that reads
-* instruction files knows the tree exists without a host-specific session hook.
-*
-* Idempotent: a delimited block is rewritten in place, never appended twice, so
-* switching the connected tree updates the existing pointer. All other content is
-* preserved, and an existing regular `CLAUDE.md` is left alone.
-*/
-function writeProjectPointer(projectPath, treePath) {
-	const agentsPath = join(projectPath, "AGENTS.md");
-	const block = pointerBlock(treePath);
-	const existing = regularFileContent(agentsPath);
-	if (existing === void 0) {
-		writeFileSync(agentsPath, `# AGENTS.md\n\n${block}\n`, {
-			encoding: "utf8",
-			mode: 420
-		});
-		linkClaudeMarkdown(projectPath);
-		return "written";
-	}
-	const start = existing.indexOf(BEGIN);
-	const end = existing.indexOf(END);
-	if (start !== -1 && end > start) {
-		const replaced = `${existing.slice(0, start)}${block}${existing.slice(end + 25)}`;
-		if (replaced === existing) return "skipped";
-		writeFileSync(agentsPath, replaced, { encoding: "utf8" });
-		return "updated";
-	}
-	writeFileSync(agentsPath, `${existing}${existing.endsWith("\n\n") ? "" : existing.endsWith("\n") ? "\n" : "\n\n"}${block}\n`, { encoding: "utf8" });
-	linkClaudeMarkdown(projectPath);
-	return "written";
-}
-/** Point CLAUDE.md at AGENTS.md only when the project has no CLAUDE.md of its own. */
-function linkClaudeMarkdown(projectPath) {
-	const claudePath = join(projectPath, "CLAUDE.md");
-	if (lstatSync(claudePath, { throwIfNoEntry: false }) !== void 0) return;
+//#region src/core/internal/project-instructions.ts
+/** Best-effort convenience link; existing project instruction entries are never changed. */
+function linkProjectInstructions(projectPath) {
 	try {
+		if (!lstatSync(join(projectPath, "AGENTS.md"), { throwIfNoEntry: false })?.isFile()) return;
+		const claudePath = join(projectPath, "CLAUDE.md");
+		if (lstatSync(claudePath, { throwIfNoEntry: false }) !== void 0) return;
 		symlinkSync("AGENTS.md", claudePath, "file");
 	} catch {}
 }
@@ -25666,14 +25605,14 @@ function realManagedDirectory(name, destination) {
 * clean, fully valid Git checkout at an explicit disk path in place.
 */
 function connectProject(options, runner) {
-	/** Store the connection, then record it in the project so any agent can find it. */
+	/** Store the connection and offer instruction discovery for existing project instructions. */
 	const connect = (tree) => {
 		const result = upsertConnection({
 			projectPath: options.projectPath,
 			tree
 		}, runner);
+		linkProjectInstructions(canonicalProjectRoot(options.projectPath, runner));
 		return {
-			pointer: writeProjectPointer(canonicalProjectRoot(options.projectPath, runner), result.tree.path),
 			schemaVersion: 1,
 			tree: result.tree
 		};
@@ -25866,21 +25805,23 @@ function projectName(canonicalRoot) {
 	return /^[a-z\d]/u.test(normalized) ? normalized : "project";
 }
 function existingCreateResult(canonical, destination, runner) {
+	const branch = git(destination, [
+		"symbolic-ref",
+		"--short",
+		"HEAD"
+	], {
+		message: "Failed to resolve the managed tree branch.",
+		runner
+	});
+	const commitSha = git(destination, ["rev-parse", "HEAD"], {
+		message: "Failed to resolve the managed tree commit.",
+		runner
+	});
+	linkProjectInstructions(canonical);
 	return {
-		branch: git(destination, [
-			"symbolic-ref",
-			"--short",
-			"HEAD"
-		], {
-			message: "Failed to resolve the managed tree branch.",
-			runner
-		}),
-		commitSha: git(destination, ["rev-parse", "HEAD"], {
-			message: "Failed to resolve the managed tree commit.",
-			runner
-		}),
+		branch,
+		commitSha,
 		created: false,
-		pointer: writeProjectPointer(canonical, destination),
 		schemaVersion: 1,
 		title: readRootNode(destination).frontmatter.title,
 		treePath: destination
@@ -25912,11 +25853,11 @@ function createProject(projectPath, runner) {
 				path: scaffold.root
 			}
 		}, runner);
+		linkProjectInstructions(canonical);
 		return {
 			branch: scaffold.branch,
 			commitSha: scaffold.commit,
 			created: true,
-			pointer: writeProjectPointer(canonical, scaffold.root),
 			schemaVersion: 1,
 			title: name,
 			treePath: scaffold.root
@@ -26526,11 +26467,6 @@ function reclaimAbandonedWrites(root, checkoutBranch, runner) {
 }
 //#endregion
 //#region src/cli/format.ts
-const POINTER_NOTE = {
-	skipped: "left unchanged",
-	updated: "updated",
-	written: "written"
-};
 function treeLines(tree, indent = "  ") {
 	const lines = [`${indent}Path:       ${tree.path}`];
 	if (tree.kind === "github") lines.push(`${indent}Repository: ${tree.repository}`);
@@ -26541,16 +26477,11 @@ function formatCreate(result) {
 		`${result.created ? "Created" : "Reused"} managed Context Tree "${result.title}".`,
 		`  Path:     ${result.treePath}`,
 		`  Branch:   ${result.branch}`,
-		`  Commit:   ${result.commitSha}`,
-		`  AGENTS.md: ${POINTER_NOTE[result.pointer]}`
+		`  Commit:   ${result.commitSha}`
 	].join("\n");
 }
 function formatConnect(result) {
-	return [
-		`Connected ${result.tree.kind} Context Tree.`,
-		...treeLines(result.tree),
-		`  AGENTS.md:  ${POINTER_NOTE[result.pointer]}`
-	].join("\n");
+	return [`Connected ${result.tree.kind} Context Tree.`, ...treeLines(result.tree)].join("\n");
 }
 function formatResolve(result) {
 	return [`Connected ${result.tree.kind} Context Tree.`, ...treeLines(result.tree)].join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@first-tree-ai/context-tree",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Durable, structured project context for coding agents: a CLI plus framework-neutral skills.",
   "type": "module",
   "license": "Apache-2.0",

package/skills/context-tree-connect/SKILL.md

@@ -26,11 +26,6 @@ for a target yourself; pass through only what the user typed or confirmed. An
 explicit connect switches the project's connection. Report whether the
 connected tree is local or GitHub-backed, with its canonical path.
 
-`connect` also records the tree in the project's own `AGENTS.md`, replacing any
-previous Context Tree pointer rather than adding a second one. The result's
-`pointer` field reports `written`, `updated`, or `skipped`; when it is not
-`skipped`, tell the user that `AGENTS.md` in their project changed.
-
 If connection reports `INVALID_TREE` or `DIRTY_TREE`, report the failure and
 stop. The tree must be repaired or committed at its own location before it can
 be connected.

package/skills/context-tree-create/SKILL.md

@@ -20,11 +20,6 @@ already taken, or the project is already connected to a different tree, report
 the `connect` command the error supplies and stop. Do not replace or remove the
 existing managed tree or connection.
 
-`create` also records the tree in the project's own `AGENTS.md`, so later
-sessions and other agents find it without any host-specific setup. The result's
-`pointer` field reports `written`, `updated`, or `skipped`; when it is not
-`skipped`, tell the user that `AGENTS.md` in their project changed.
-
 After the tree is created or reused, run `context-tree resolve --json`. When the tree is
 local, ask the user whether to publish it as a private GitHub repository. An
 explicit prior request to publish counts as confirmation; otherwise a "no"