localptp 0.1.0

package/dist/utils/gitRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitRoot.js","sourceRoot":"","sources":["../../src/utils/gitRoot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOvC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Redact common secret shapes from a line before it is written or printed.
+ */
+export declare function redactSecrets(line: string): string;
+export interface LoggerOptions {
+    logsDir: string;
+    debug?: boolean;
+}
+export interface Logger {
+    info(message: string): Promise<void>;
+    warn(message: string): Promise<void>;
+    error(message: string): Promise<void>;
+    debug(message: string): Promise<void>;
+}
+export declare function createLogger(opts: LoggerOptions): Logger;

package/dist/utils/logger.js

@@ -0,0 +1,60 @@
+/**
+ * Secret-safe local logger (HLD-SRD §13, §14).
+ *
+ * Writes `.ai-orchestrator/logs/YYYY-MM-DD.log`. Never logs secrets: bearer
+ * tokens, api_key/apiKey values, and connection-string credentials are redacted
+ * before anything is written. `debug` lines are written only when debug is on.
+ */
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const REDACTED = "[REDACTED]";
+/**
+ * Redact common secret shapes from a line before it is written or printed.
+ */
+export function redactSecrets(line) {
+    return (line
+        // Bearer tokens
+        .replace(/(Bearer\s+)\S+/gi, `$1${REDACTED}`)
+        // api_key / apiKey = "quoted value" (may contain whitespace) — redact the
+        // whole quoted value so secrets with spaces never leak. The key itself may
+        // be quoted too (JSON: "apiKey":"secret"). The value matcher is
+        // escape-aware: an escaped quote (\") inside the value does NOT terminate
+        // it, so the entire secret is redacted.
+        .replace(/(["']?api[_-]?key["']?\s*[:=]\s*)(["'])(?:\\.|(?!\2)[\s\S])*\2/gi, `$1$2${REDACTED}$2`)
+        // api_key / apiKey = unquoted value. Redact the WHOLE plain scalar up to
+        // the end of line or an inline ` #` comment — a YAML plain scalar may
+        // contain spaces (e.g. `api_key: secret phrase`), so stopping at the first
+        // space would leak the rest.
+        .replace(/(["']?api[_-]?key["']?\s*[:=]\s*)(?!["'])[^\n\r]+/gi, `$1${REDACTED}`)
+        // Credentials embedded in a URL (user:pass@host) and the rest of the URL,
+        // which may itself carry secrets — redact from the scheme onward. The
+        // scheme grammar follows RFC 3986 (letters, then letters/digits/+/-/.) so
+        // schemes like `mongodb+srv://` and `postgresql://` are covered.
+        .replace(/\b[A-Za-z][A-Za-z0-9+.-]*:\/\/[^\s]*@[^\s]+/g, REDACTED));
+}
+function dateStamp(d = new Date()) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+export function createLogger(opts) {
+    const { logsDir, debug = false } = opts;
+    async function write(level, message) {
+        const safe = redactSecrets(message);
+        const line = `${new Date().toISOString()} [${level}] ${safe}\n`;
+        await fs.mkdir(logsDir, { recursive: true });
+        await fs.appendFile(path.join(logsDir, `${dateStamp()}.log`), line, "utf8");
+    }
+    return {
+        info: (m) => write("INFO", m),
+        warn: (m) => write("WARN", m),
+        error: (m) => write("ERROR", m),
+        debug: async (m) => {
+            if (!debug)
+                return;
+            await write("DEBUG", m);
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,CACL,IAAI;QACF,gBAAgB;SACf,OAAO,CAAC,kBAAkB,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC7C,0EAA0E;QAC1E,2EAA2E;QAC3E,gEAAgE;QAChE,0EAA0E;QAC1E,wCAAwC;SACvC,OAAO,CACN,kEAAkE,EAClE,OAAO,QAAQ,IAAI,CACpB;QACD,yEAAyE;QACzE,sEAAsE;QACtE,2EAA2E;QAC3E,6BAA6B;SAC5B,OAAO,CACN,qDAAqD,EACrD,KAAK,QAAQ,EAAE,CAChB;QACD,0EAA0E;QAC1E,sEAAsE;QACtE,0EAA0E;QAC1E,iEAAiE;SAChE,OAAO,CAAC,8CAA8C,EAAE,QAAQ,CAAC,CACrE,CAAC;AACJ,CAAC;AAcD,SAAS,SAAS,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE;IAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAExC,KAAK,UAAU,KAAK,CAAC,KAAa,EAAE,OAAe;QACjD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC;QAChE,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/B,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACjB,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,13 @@
+export interface Layout {
+    root: string;
+    orchestratorDir: string;
+    configFile: string;
+    logsDir: string;
+    contextPackagesDir: string;
+    aiDir: string;
+    tasksDir: string;
+    sessionsDir: string;
+    gitignoreFile: string;
+    memoryFile(name: string): string;
+}
+export declare function layout(root: string): Layout;

package/dist/utils/paths.js

@@ -0,0 +1,24 @@
+/**
+ * Path layout for the `.ai-orchestrator` internal dir and the `/ai` memory dir
+ * (HLD-SRD §4). The `/ai` dir is rooted directly at the repo root.
+ */
+import path from "node:path";
+export function layout(root) {
+    const orchestratorDir = path.join(root, ".ai-orchestrator");
+    const aiDir = path.join(root, "ai");
+    return {
+        root,
+        orchestratorDir,
+        configFile: path.join(orchestratorDir, "config.yml"),
+        logsDir: path.join(orchestratorDir, "logs"),
+        contextPackagesDir: path.join(orchestratorDir, "context-packages"),
+        aiDir,
+        tasksDir: path.join(aiDir, "tasks"),
+        sessionsDir: path.join(aiDir, "sessions"),
+        gitignoreFile: path.join(root, ".gitignore"),
+        memoryFile(name) {
+            return path.join(aiDir, name);
+        },
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAe7B,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,OAAO;QACL,IAAI;QACJ,eAAe;QACf,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC;QACpD,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC;QAC3C,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC;QAClE,KAAK;QACL,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;QACnC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC;QACzC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;QAC5C,UAAU,CAAC,IAAY;YACrB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/tokenEstimate.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Rough token estimate for MVP budgeting (HLD-SRD §6): chars / 4.
+ * A tokenizer-accurate count lands in a later slice.
+ */
+export declare function estimateTokens(text: string): number;

package/dist/utils/tokenEstimate.js

@@ -0,0 +1,8 @@
+/**
+ * Rough token estimate for MVP budgeting (HLD-SRD §6): chars / 4.
+ * A tokenizer-accurate count lands in a later slice.
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=tokenEstimate.js.map

package/dist/utils/tokenEstimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenEstimate.js","sourceRoot":"","sources":["../../src/utils/tokenEstimate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "localptp",
+  "version": "0.1.0",
+  "description": "LocalCode Orchestrator CLI — drives a local coding model over large codebases.",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "localptp": "dist/cli.js",
+    "localcoder": "dist/cli.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "echo \"lint placeholder — no linter configured yet\"",
+    "localptp": "tsx src/cli.ts",
+    "localcoder": "tsx src/cli.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "diff": "^5.2.0",
+    "execa": "^9.3.0",
+    "js-yaml": "^4.1.0",
+    "simple-git": "^3.25.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/diff": "^5.2.1",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.14.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}