threadbase 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ani3198
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,195 @@
+# Threadbase
+
+Threadbase makes the repository itself the memory layer for AI-assisted development.
+
+Instead of keeping project context trapped inside one chat thread, one IDE, or one vendor-specific memory system, Threadbase stores it in plain Markdown inside the repo. That means your architecture decisions, recent changes, requirements, and known issues live alongside the code, under version control, where any coding agent can use them.
+
+## What Threadbase Is
+
+Threadbase is:
+
+- repo-native: project memory lives in the repository
+- git-native: memory is stored as normal files and folders that work with commits, diffs, branches, and reviews
+- agent-agnostic: the core memory is plain Markdown, and the tool-specific adapter files all point agents at the same shared context
+- lightweight: no backend, database, daemon, browser UI, or cloud dependency
+
+Threadbase is not:
+
+- a SaaS memory product
+- a vector database
+- a workflow orchestrator
+- a tool that only works with one coding assistant
+
+## Why This Exists
+
+Teams repeatedly re-explain the same project context to different agents:
+
+- what the architecture looks like
+- what changed recently
+- what constraints matter
+- what issues are still open
+
+Threadbase solves that by making those facts durable and versioned inside the codebase itself.
+
+## Core Idea
+
+Threadbase creates a small `.ai/` directory in a repository.
+
+The important rule is simple:
+
+- `.ai/memory/*` is the source of truth
+- `.ai/generated/context.md` is derived from that memory
+- adapter files such as `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md` tell different agents to read the same shared context
+
+So the memory model is shared, even if the agents are different.
+
+## How It Works
+
+1. Run `threadbase init` in a repository.
+2. Threadbase creates the shared memory structure in `.ai/` plus agent-specific adapter files.
+3. Before coding, an agent reads `.ai/rules.md` and `.ai/generated/context.md`.
+4. After meaningful work, the agent adds or updates memory entries in `.ai/memory/*`.
+5. When context becomes stale, the agent regenerates `.ai/generated/context.md` from the memory files.
+
+This keeps the repo usable across sessions, branches, and different AI tools without changing the underlying memory model.
+
+## Supported Agents
+
+Threadbase currently generates adapter files for:
+
+- Codex via `AGENTS.md`
+- Claude Code via `CLAUDE.md`
+- Gemini CLI / Gemini Code Assist via `GEMINI.md`
+- GitHub Copilot via `.github/copilot-instructions.md`
+- Cursor via `.cursor/rules/threadbase.mdc`
+- Continue via `.continue/rules/threadbase.md`
+- Windsurf via `.windsurf/rules/threadbase.md`
+- Cline via `.clinerules/threadbase.md`
+
+These files are adapters, not separate memory systems. They all point back to the same repo-native Threadbase memory.
+
+## Install
+
+```bash
+npm install -g threadbase
+```
+
+Then in any repository:
+
+```bash
+threadbase init
+```
+
+If you want the generated Threadbase files to stay local and untracked in your current working tree:
+
+```bash
+threadbase init --local
+```
+
+Until the first npm release is published, local development still uses:
+
+```bash
+npm install
+npm run build
+npm link
+```
+
+## Commands
+
+Initialize Threadbase in the current repository:
+
+```bash
+threadbase init
+```
+
+Initialize Threadbase and add its generated files to `.gitignore`:
+
+```bash
+threadbase init --local
+```
+
+Overwrite only Threadbase-managed starter files:
+
+```bash
+threadbase init --force
+```
+
+`--force` is safe by design:
+
+- it rewrites starter templates managed by Threadbase
+- it recreates missing directories
+- it does not delete unknown files
+- it does not rewrite files under `.ai/memory/*`
+
+`--local` adds Threadbase-managed paths to `.gitignore`:
+
+- `.ai/`
+- `AGENTS.md`
+- `CLAUDE.md`
+- `GEMINI.md`
+- `.cursor/rules/threadbase.mdc`
+- `.github/copilot-instructions.md`
+- `.continue/rules/threadbase.md`
+- `.windsurf/rules/threadbase.md`
+- `.clinerules/threadbase.md`
+
+## Generated Structure
+
+```text
+.ai/
+├── config.yml
+├── generated/
+│   └── context.md
+├── memory/
+│   ├── changes/
+│   ├── decisions/
+│   ├── issues/
+│   └── requirements/
+├── prompts/
+│   └── generate_context.md
+├── rules.md
+└── schema.md
+
+AGENTS.md
+CLAUDE.md
+GEMINI.md
+.continue/rules/threadbase.md
+.clinerules/threadbase.md
+.cursor/rules/threadbase.mdc
+.github/copilot-instructions.md
+.windsurf/rules/threadbase.md
+```
+
+What matters most in that structure:
+
+- `.ai/memory/*` is the authoritative memory layer
+- `.ai/generated/context.md` is a compact generated summary for fast agent onboarding
+- adapter files at the repo root or tool-specific folders help different agents discover the same memory
+
+## Example Workflow
+
+1. Initialize Threadbase in a repository.
+2. Let your coding agent read `.ai/generated/context.md` before making meaningful changes.
+3. Make code changes.
+4. Record important changes, decisions, requirements, or issues in `.ai/memory/*`.
+5. Regenerate `.ai/generated/context.md` when it becomes stale.
+
+See [examples/workflow.md](/Users/aniketrode/Documents/Threadbase/threadbase/examples/workflow.md) for a simple end-to-end example.
+See [examples/sample-repo](/Users/aniketrode/Documents/Threadbase/threadbase/examples/sample-repo) for a sample initialized repository snapshot.
+
+## Development
+
+```bash
+npm run check
+npm run build
+```
+
+## Publishing
+
+```bash
+npm login
+npm whoami
+npm publish
+```
+
+`prepublishOnly` runs typecheck and build before publish so the npm package includes the compiled CLI.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { runInit } from "./init.js";
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    const force = args.includes("--force");
+    const local = args.includes("--local");
+    const help = args.includes("--help") || args.includes("-h");
+    if (help || !command) {
+        printHelp();
+        process.exit(help ? 0 : 1);
+    }
+    if (command !== "init") {
+        console.error(`Unknown command: ${command}`);
+        printHelp();
+        process.exit(1);
+    }
+    const result = await runInit({
+        cwd: process.cwd(),
+        force,
+        local
+    });
+    console.log("Threadbase initialized.");
+    console.log(`Directories ensured: ${result.directoriesEnsured.length}`);
+    console.log(`Files created: ${result.created.length}`);
+    console.log(`Files overwritten: ${result.overwritten.length}`);
+    console.log(`Files skipped: ${result.skipped.length}`);
+    if (local) {
+        console.log(`.gitignore created: ${result.gitignoreCreated ? "yes" : "no"}`);
+        console.log(`.gitignore updated: ${result.gitignoreUpdated ? "yes" : "no"}`);
+        console.log(`.gitignore entries added: ${result.gitignoreEntriesAdded.length}`);
+    }
+    if (result.created.length > 0) {
+        console.log("");
+        console.log("Created:");
+        for (const item of result.created) {
+            console.log(`- ${item}`);
+        }
+    }
+    if (result.overwritten.length > 0) {
+        console.log("");
+        console.log("Overwritten:");
+        for (const item of result.overwritten) {
+            console.log(`- ${item}`);
+        }
+    }
+    if (result.skipped.length > 0) {
+        console.log("");
+        console.log("Skipped existing files:");
+        for (const item of result.skipped) {
+            console.log(`- ${item}`);
+        }
+    }
+    if (local && result.gitignoreEntriesAdded.length > 0) {
+        console.log("");
+        console.log("Added to .gitignore:");
+        for (const item of result.gitignoreEntriesAdded) {
+            console.log(`- ${item}`);
+        }
+    }
+}
+function printHelp() {
+    console.log(`Threadbase
+
+Usage:
+  threadbase init [--force] [--local]
+
+Commands:
+  init        Create the Threadbase repository structure in the current directory
+
+Options:
+  --force     Overwrite Threadbase-managed starter files
+  --local     Add Threadbase-managed paths to .gitignore
+  -h, --help  Show help
+`);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`threadbase failed: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE5D,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;QAC7C,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;QAC3B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,KAAK;QACL,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,KAAK,IAAI,MAAM,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;CAYb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,16 @@
+export type InitResult = {
+    created: string[];
+    overwritten: string[];
+    skipped: string[];
+    directoriesEnsured: string[];
+    gitignoreCreated: boolean;
+    gitignoreUpdated: boolean;
+    gitignoreEntriesAdded: string[];
+};
+type InitOptions = {
+    cwd: string;
+    force: boolean;
+    local: boolean;
+};
+export declare function runInit(options: InitOptions): Promise<InitResult>;
+export {};

package/dist/init.js

@@ -0,0 +1,107 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { localIgnoreEntries, managedTemplates, memoryDirectories } from "./templates.js";
+export async function runInit(options) {
+    const directoriesEnsured = [
+        ".ai",
+        ".ai/prompts",
+        ".ai/generated",
+        ".ai/memory",
+        ".continue",
+        ".continue/rules",
+        ".cursor",
+        ".cursor/rules",
+        ".github",
+        ".windsurf",
+        ".windsurf/rules",
+        ".clinerules",
+        ...memoryDirectories
+    ];
+    for (const relativeDir of directoriesEnsured) {
+        await mkdir(path.join(options.cwd, relativeDir), { recursive: true });
+    }
+    const result = {
+        created: [],
+        overwritten: [],
+        skipped: [],
+        directoriesEnsured,
+        gitignoreCreated: false,
+        gitignoreUpdated: false,
+        gitignoreEntriesAdded: []
+    };
+    for (const template of managedTemplates) {
+        const targetPath = path.join(options.cwd, template.path);
+        const existingContents = await tryReadFile(targetPath);
+        if (existingContents !== null && !options.force) {
+            result.skipped.push(template.path);
+            continue;
+        }
+        await writeFile(targetPath, template.contents, "utf8");
+        if (existingContents === null) {
+            result.created.push(template.path);
+        }
+        else {
+            result.overwritten.push(template.path);
+        }
+    }
+    if (options.local) {
+        const gitignoreUpdate = await ensureLocalGitignore(options.cwd);
+        result.gitignoreCreated = gitignoreUpdate.created;
+        result.gitignoreUpdated = gitignoreUpdate.updated;
+        result.gitignoreEntriesAdded = gitignoreUpdate.entriesAdded;
+    }
+    return result;
+}
+async function ensureLocalGitignore(cwd) {
+    const gitignorePath = path.join(cwd, ".gitignore");
+    const existingContents = await tryReadFile(gitignorePath);
+    const normalized = existingContents ?? "";
+    const entriesAdded = localIgnoreEntries.filter((entry) => !hasGitignoreEntry(normalized, entry));
+    if (existingContents === null) {
+        await writeFile(gitignorePath, buildLocalGitignoreBlock(localIgnoreEntries), "utf8");
+        return {
+            created: true,
+            updated: true,
+            entriesAdded: [...localIgnoreEntries]
+        };
+    }
+    if (entriesAdded.length === 0) {
+        return {
+            created: false,
+            updated: false,
+            entriesAdded: []
+        };
+    }
+    const prefix = normalized.endsWith("\n") || normalized.length === 0 ? normalized : `${normalized}\n`;
+    const block = buildLocalGitignoreBlock(entriesAdded);
+    await writeFile(gitignorePath, `${prefix}${block}`, "utf8");
+    return {
+        created: false,
+        updated: true,
+        entriesAdded
+    };
+}
+function hasGitignoreEntry(contents, entry) {
+    const lines = contents.split(/\r?\n/).map((line) => line.trim());
+    return lines.includes(entry);
+}
+function buildLocalGitignoreBlock(entries) {
+    return [
+        "# Threadbase local mode",
+        ...entries,
+        ""
+    ].join("\n");
+}
+async function tryReadFile(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/templates.d.ts

@@ -0,0 +1,7 @@
+export type ManagedTemplate = {
+    path: string;
+    contents: string;
+};
+export declare const localIgnoreEntries: string[];
+export declare const managedTemplates: ManagedTemplate[];
+export declare const memoryDirectories: string[];

package/dist/templates.js

@@ -0,0 +1,271 @@
+export const localIgnoreEntries = [
+    ".ai/",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "GEMINI.md",
+    ".cursor/rules/threadbase.mdc",
+    ".github/copilot-instructions.md",
+    ".continue/rules/threadbase.md",
+    ".windsurf/rules/threadbase.md",
+    ".clinerules/threadbase.md"
+];
+export const managedTemplates = [
+    {
+        path: ".ai/rules.md",
+        contents: `# Threadbase Rules
+
+Read \`.ai/generated/context.md\` before making meaningful code changes.
+
+## Expectations
+
+- Treat \`.ai/memory/*\` as the source of truth.
+- Update memory after important implementation changes, decisions, or newly discovered issues.
+- Regenerate \`.ai/generated/context.md\` if it is missing, empty, or outdated.
+- Never store secrets, tokens, API keys, or credentials in Threadbase files.
+
+## Safety
+
+- Keep memory entries small, focused, and append-only.
+- Prefer one markdown file per decision, change, requirement, or issue.
+- Do not manually maintain \`.ai/generated/context.md\`; regenerate it from memory.
+`
+    },
+    {
+        path: ".ai/prompts/generate_context.md",
+        contents: `# Generate Threadbase Context
+
+You are generating \`.ai/generated/context.md\` for this repository.
+
+## Goal
+
+Create a compact, information-dense project context that helps coding agents get oriented quickly.
+
+## Inputs
+
+Read all markdown files under:
+
+- \`.ai/memory/decisions/\`
+- \`.ai/memory/changes/\`
+- \`.ai/memory/requirements/\`
+- \`.ai/memory/issues/\`
+
+Treat those files as the source of truth.
+
+## Output Rules
+
+- Write to \`.ai/generated/context.md\`.
+- Use YAML frontmatter with:
+  - \`generated_at\`
+  - \`source_file_count\`
+- Keep the summary concise and architecture-focused.
+- Prefer concrete implementation facts over vague prose.
+- Mention contradictions or open questions plainly.
+
+## Required Sections
+
+1. Architecture
+2. Current State
+3. Constraints
+4. Recent Changes
+5. Important Decisions
+6. Known Issues
+`
+    },
+    {
+        path: ".ai/generated/context.md",
+        contents: `---
+generated_at: 1970-01-01T00:00:00Z
+source_file_count: 0
+---
+
+# Project Context
+
+## Architecture
+
+Context has not been generated from memory yet.
+
+## Current State
+
+Threadbase was initialized, but no memory entries exist yet.
+
+## Constraints
+
+- \`.ai/memory/*\` is the source of truth.
+- This file is derived and can be regenerated at any time.
+
+## Recent Changes
+
+- Initialized Threadbase structure.
+
+## Important Decisions
+
+- None recorded yet.
+
+## Known Issues
+
+- Context should be regenerated after the first real memory entries are added.
+`
+    },
+    {
+        path: ".ai/schema.md",
+        contents: `# Threadbase V1 Schema
+
+## Source of Truth
+
+- Authoritative project memory lives in \`.ai/memory/*\`.
+- \`.ai/generated/context.md\` is derived and disposable.
+
+## Memory Folders
+
+- \`.ai/memory/decisions/\`: architectural and product decisions.
+- \`.ai/memory/changes/\`: notable implementation changes.
+- \`.ai/memory/requirements/\`: evolving requirements and constraints.
+- \`.ai/memory/issues/\`: known bugs, risks, and open problems.
+
+## File Naming
+
+- One memory entry per file.
+- Use: \`YYYYMMDD-HHMM-short-slug.md\`
+
+Example:
+
+\`20260517-1430-add-init-command.md\`
+
+## Required Frontmatter
+
+- \`id\`
+- \`type\`
+- \`created_at\`
+- \`summary\`
+
+## Minimum Body Structure
+
+Every memory entry should include:
+
+- \`## Context\`
+- \`## Details\`
+`
+    },
+    {
+        path: ".ai/config.yml",
+        contents: `version: 1
+context_file: .ai/generated/context.md
+memory_root: .ai/memory
+generate_context_prompt: .ai/prompts/generate_context.md
+`
+    },
+    {
+        path: "AGENTS.md",
+        contents: `# Threadbase Agent Instructions
+
+Before coding:
+
+1. Read \`.ai/rules.md\`
+2. Read \`.ai/generated/context.md\`
+
+After coding:
+
+1. Update relevant memory files in \`.ai/memory/*\`
+2. Regenerate \`.ai/generated/context.md\` if it is missing, empty, or outdated
+
+Never store secrets in Threadbase files.
+`
+    },
+    {
+        path: "CLAUDE.md",
+        contents: `# Threadbase Instructions for Claude Code
+
+- Read \`.ai/rules.md\` before starting implementation work.
+- Read \`.ai/generated/context.md\` to understand current architecture and project state.
+- Treat \`.ai/memory/*\` as authoritative.
+- Record meaningful changes, decisions, requirements, and issues in small markdown files.
+- Never store secrets in Threadbase memory.
+`
+    },
+    {
+        path: "GEMINI.md",
+        contents: `# Threadbase Instructions for Gemini CLI
+
+- Read \`.ai/rules.md\` and \`.ai/generated/context.md\` before making meaningful code changes.
+- Treat \`.ai/memory/*\` as the authoritative project memory.
+- Record meaningful changes, decisions, requirements, and issues in small markdown files.
+- Regenerate \`.ai/generated/context.md\` if it is missing, empty, or outdated.
+- Never store secrets, tokens, API keys, or credentials in Threadbase files.
+`
+    },
+    {
+        path: ".cursor/rules/threadbase.mdc",
+        contents: `---
+description: Threadbase repository memory workflow
+alwaysApply: true
+---
+
+Read \`.ai/rules.md\` and \`.ai/generated/context.md\` before making meaningful changes.
+
+Treat \`.ai/memory/*\` as the source of truth.
+
+After important work:
+
+- update memory
+- regenerate context if missing or outdated
+
+Never store secrets in Threadbase files.
+`
+    },
+    {
+        path: ".github/copilot-instructions.md",
+        contents: `# Threadbase Instructions for GitHub Copilot
+
+- Read \`.ai/generated/context.md\` before making important changes.
+- Use \`.ai/memory/*\` as the source of truth for decisions, changes, requirements, and issues.
+- Update project memory after meaningful work.
+- Regenerate context from memory when context is missing, empty, or stale.
+- Do not store secrets in Threadbase files.
+`
+    },
+    {
+        path: ".continue/rules/threadbase.md",
+        contents: `# Threadbase Rule
+
+- Read \`.ai/generated/context.md\` before making meaningful code changes.
+- Treat \`.ai/memory/*\` as the source of truth for decisions, changes, requirements, and issues.
+- Update Threadbase memory after important implementation work.
+- Regenerate \`.ai/generated/context.md\` when it is missing, empty, or stale.
+- Never store secrets in Threadbase files.
+`
+    },
+    {
+        path: ".windsurf/rules/threadbase.md",
+        contents: `---
+trigger: always_on
+description: Threadbase project memory workflow
+---
+
+# Threadbase Rule
+
+- Read \`.ai/generated/context.md\` before making meaningful code changes.
+- Treat \`.ai/memory/*\` as the source of truth for decisions, changes, requirements, and issues.
+- Update Threadbase memory after important implementation work.
+- Regenerate \`.ai/generated/context.md\` when it is missing, empty, or stale.
+- Never store secrets in Threadbase files.
+`
+    },
+    {
+        path: ".clinerules/threadbase.md",
+        contents: `# Threadbase Rule
+
+- Read \`.ai/generated/context.md\` before making meaningful code changes.
+- Treat \`.ai/memory/*\` as the source of truth for decisions, changes, requirements, and issues.
+- Update Threadbase memory after important implementation work.
+- Regenerate \`.ai/generated/context.md\` when it is missing, empty, or stale.
+- Never store secrets in Threadbase files.
+`
+    }
+];
+export const memoryDirectories = [
+    ".ai/memory/decisions",
+    ".ai/memory/changes",
+    ".ai/memory/requirements",
+    ".ai/memory/issues"
+];
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM;IACN,WAAW;IACX,WAAW;IACX,WAAW;IACX,8BAA8B;IAC9B,iCAAiC;IACjC,+BAA+B;IAC/B,+BAA+B;IAC/B,2BAA2B;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD;QACE,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE;;;;;;;;;;;;;;;;CAgBb;KACE;IACD;QACE,IAAI,EAAE,iCAAiC;QACvC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCb;KACE;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Bb;KACE;IACD;QACE,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCb;KACE;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE;;;;CAIb;KACE;IACD;QACE,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE;;;;;;;;;;;;;CAab;KACE;IACD;QACE,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE;;;;;;;CAOb;KACE;IACD;QACE,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE;;;;;;;CAOb;KACE;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,QAAQ,EAAE;;;;;;;;;;;;;;;CAeb;KACE;IACD;QACE,IAAI,EAAE,iCAAiC;QACvC,QAAQ,EAAE;;;;;;;CAOb;KACE;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE;;;;;;;CAOb;KACE;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE;;;;;;;;;;;;CAYb;KACE;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE;;;;;;;CAOb;KACE;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,sBAAsB;IACtB,oBAAoB;IACpB,yBAAyB;IACzB,mBAAmB;CACpB,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "threadbase",
+  "version": "0.1.0",
+  "description": "Repo-native persistent memory for AI-assisted software development.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "threadbase": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc --noEmit -p tsconfig.json",
+    "prepublishOnly": "npm run check && npm run build",
+    "start": "node dist/cli.js",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "developer-tools",
+    "memory",
+    "threadbase"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.8.0",
+    "typescript": "^6.0.3"
+  }
+}