ithos 0.1.2 → 0.1.4

package/README.md

@@ -1,10 +1,13 @@
 # ithos
 
-> The terminal CLI for Ithos — the local-first institutional memory layer for AI-assisted software development.
+> The terminal CLI for Ithos — the local-first institutional memory layer for
+> AI-assisted software development.
 
-This is the command-line client used to initialize and manage an Ithos repository.
+This is the command-line client used to initialize and manage an Ithos
+repository.
 
-For the full documentation, architecture details, and MCP setup guides, please visit the [Main Ithos Repository](https://github.com/kry5h/ithos).
+For the full documentation, architecture details, and MCP setup guides, please
+visit the [Main Ithos Repository](https://github.com/kry5h/ithos).
 
 ## Installation
 

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,SAAS,IAAI,OAAO,CAiHnC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,SAAS,IAAI,OAAO,CAkInC"}

package/dist/cli.js

@@ -1,11 +1,11 @@
 import { Command } from "commander";
-import { doctorRepository, exportMemory, initRepository, isArtifactType, recordArtifact, searchMemory, validateRepository } from "ithos-core";
+import { doctorRepository, exportMemory, generateTimeline, initRepository, isArtifactType, recordArtifact, searchMemory, validateRepository } from "ithos-core";
 export function createCli() {
     const program = new Command();
     program
         .name("ithos")
         .description("Local-first engineering memory")
-        .version("0.1.0");
+        .version("0.1.4");
     program
         .command("init")
         .description("Initialize Ithos memory in the current repository")
@@ -56,8 +56,12 @@ export function createCli() {
             process.exitCode = 1;
             return;
         }
-        const tags = options.tags ? options.tags.split(",").map(t => t.trim()) : undefined;
-        const related = options.related ? options.related.split(",").map(r => r.trim()) : undefined;
+        const tags = options.tags
+            ? options.tags.split(",").map((t) => t.trim())
+            : undefined;
+        const related = options.related
+            ? options.related.split(",").map((r) => r.trim())
+            : undefined;
         const file = await recordArtifact({
             type: options.type,
             title: options.title,
@@ -88,6 +92,13 @@ export function createCli() {
         const result = await exportMemory();
         process.stdout.write(result.markdown);
     });
+    program
+        .command("timeline")
+        .description("Show a chronological timeline of engineering memory")
+        .action(async () => {
+        const result = await generateTimeline();
+        renderTimeline(result);
+    });
     return program;
 }
 function printList(label, values) {
@@ -104,3 +115,83 @@ async function readStdin() {
     }
     return Buffer.concat(chunks).toString("utf8");
 }
+// ---------------------------------------------------------------------------
+// Timeline renderer
+// ---------------------------------------------------------------------------
+// Raw ANSI codes — no runtime dependency needed.
+const ANSI = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    cyan: "\x1b[36m",
+    blue: "\x1b[34m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    magenta: "\x1b[35m",
+    white: "\x1b[37m"
+};
+const TYPE_META = {
+    decisions: { icon: "\uD83D\uDCCC", color: "cyan", label: "Decision" },
+    sessions: { icon: "\uD83E\uDDE0", color: "blue", label: "Session" },
+    lessons: { icon: "\uD83D\uDCA1", color: "yellow", label: "Lesson" },
+    regressions: { icon: "\u26A0\uFE0F", color: "red", label: "Regression" },
+    defects: { icon: "\uD83D\uDC1B", color: "red", label: "Defect" },
+    architecture: { icon: "\uD83C\uDFDB\uFE0F", color: "magenta", label: "Architecture" },
+    features: { icon: "\u2728", color: "green", label: "Feature" },
+    patterns: { icon: "\uD83D\uDD01", color: "white", label: "Pattern" },
+    releases: { icon: "\uD83D\uDE80", color: "green", label: "Release" },
+    gaps: { icon: "\uD83D\uDD73\uFE0F", color: "yellow", label: "Gap" }
+};
+const SEPARATOR = ANSI.dim + "\u2500".repeat(52) + ANSI.reset;
+function c(color, text) {
+    return `${ANSI[color]}${text}${ANSI.reset}`;
+}
+function renderEntry(entry) {
+    const meta = TYPE_META[entry.type] ?? {
+        icon: "\uD83D\uDCCB",
+        color: "white",
+        label: entry.type
+    };
+    const label = meta.label.padEnd(13);
+    const header = `  ${meta.icon}  ${c(meta.color, ANSI.bold + label + ANSI.reset + ANSI[meta.color])}${entry.title}${ANSI.reset}`;
+    console.log(header);
+    for (const line of entry.summary) {
+        console.log(`  ${ANSI.dim}\u2192 ${line}${ANSI.reset}`);
+    }
+    console.log(`  ${ANSI.dim}\u21B3 ${entry.file}${ANSI.reset}`);
+}
+function renderTimeline(result) {
+    if (result.totalCount === 0) {
+        console.log(c("dim", "No engineering memory found. Run \`ithos record\` to capture your first artifact."));
+        return;
+    }
+    const dates = [...result.groupedByDate.keys()];
+    console.log("");
+    dates.forEach((date, dateIndex) => {
+        const entries = result.groupedByDate.get(date);
+        // Date header
+        console.log(ANSI.bold + date + ANSI.reset);
+        console.log("");
+        entries.forEach((entry, entryIndex) => {
+            renderEntry(entry);
+            // Blank line between entries on the same date
+            if (entryIndex < entries.length - 1)
+                console.log("");
+        });
+        console.log("");
+        // Separator between date groups (not after the last one)
+        if (dateIndex < dates.length - 1) {
+            console.log(SEPARATOR);
+            console.log("");
+        }
+    });
+    // Footer
+    const dayCount = dates.length;
+    const entryWord = result.totalCount === 1 ? "entry" : "entries";
+    const dayWord = dayCount === 1 ? "day" : "days";
+    console.log(ANSI.dim +
+        `  ${result.totalCount} ${entryWord} across ${dayCount} ${dayWord}` +
+        ANSI.reset);
+    console.log("");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ithos",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "license": "MIT",
   "publishConfig": {
     "access": "public"