open-code.project.json

{
  "version": 1,
  "project": {
    "id": "open-code",
    "title": "Open Code Logic Workspace",
    "summary": "A logic-first desktop workspace where project decisions are cards, cards become isolated agent work units, and human review is reserved for design conflicts."
  },
  "topics": [
    {
      "id": "logic-runtime",
      "title": "Logic Runtime",
      "summary": "The source of truth for cards, topics, dependencies, conflict detection, and generated documentation output.",
      "cardIds": [
        "card-logic-schema",
        "card-agent-coordinator",
        "card-conflict-model"
      ]
    },
    {
      "id": "desktop-shell",
      "title": "Desktop Shell",
      "summary": "A lightweight Tauri and Svelte app that lets users inspect, edit, and run logic cards.",
      "cardIds": [
        "card-logic-board-ui",
        "card-documentation-presentations",
        "card-vscode-handoff"
      ]
    },
    {
      "id": "mvp-delivery",
      "title": "MVP Delivery Track",
      "summary": "The highest-priority work still needed to move from preview to a real local agent product.",
      "cardIds": [
        "card-local-gemma-brain",
        "card-persistent-workspace",
        "card-human-conflict-resolution",
        "card-real-agent-worker",
        "card-packaged-runtime"
      ]
    }
  ],
  "cards": [
    {
      "id": "card-logic-schema",
      "title": "Readable Logic Schema",
      "summary": "Store cards and topics in GitHub-readable JSON plus generated documentation views.",
      "details": "The structured project file keeps stable card ids, topic order, dependencies, linked files, and conflict metadata. Paper, spec, roadmap, handoff, and website presentations are regenerated from the same state so reviewers can inspect logic in the format that fits the moment.",
      "status": "ready",
      "linkedFiles": [
        "crates/open-code-logic/src/lib.rs",
        "logic/open-code.project.json"
      ],
      "dependencies": [],
      "relatedCards": [
        "card-conflict-model"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-agent-coordinator",
      "title": "Parallel Agent Coordinator",
      "summary": "Run one isolated branch and worktree per active card.",
      "details": "The coordinator prepares branch names, worktree paths, and command plans. It blocks human-required logic conflicts before an agent starts, but allows code overlaps to continue into merge-agent work.",
      "status": "running",
      "linkedFiles": [
        "crates/open-code-logic/src/lib.rs",
        "packages/desktop/src-tauri/src/main.rs"
      ],
      "dependencies": [
        "card-logic-schema"
      ],
      "relatedCards": [
        "card-conflict-model"
      ],
      "implementationBranch": "open-code/card/card-agent-coordinator-parallel-agent-coordinator",
      "worktreePath": ".open-code/worktrees/card-agent-coordinator-parallel-agent-coordinator",
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-conflict-model",
      "title": "Conflict Review Model",
      "summary": "Separate agent-resolvable code overlap from human-resolved logic conflict.",
      "details": "Same-file work is an agent merge task. Contradictory behavior, duplicated design, incompatible APIs, or dependency cycles become human logic review.",
      "status": "ready",
      "linkedFiles": [
        "crates/open-code-logic/src/lib.rs",
        "packages/desktop/src/App.svelte"
      ],
      "dependencies": [
        "card-logic-schema"
      ],
      "relatedCards": [
        "card-agent-coordinator"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-logic-board-ui",
      "title": "Logic Board UI",
      "summary": "Show topics, card flow, running agents, branches, and conflict badges.",
      "details": "The main screen uses a topic rail, central logic flow, documentation presentation switcher, and an inspector. Editing happens at the card level because the card is the smallest coherent unit of logic.",
      "status": "ready",
      "linkedFiles": [
        "packages/desktop/src/App.svelte",
        "packages/desktop/src/app.css"
      ],
      "dependencies": [
        "card-logic-schema",
        "card-conflict-model"
      ],
      "relatedCards": [
        "card-documentation-presentations",
        "card-vscode-handoff"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-documentation-presentations",
      "title": "Documentation Presentations",
      "summary": "Render logic as paper, spec, roadmap, handoff, or website.",
      "details": "Paper stays useful for long-form reasoning, but the same card graph also needs dense specs, status roadmaps, agent handoffs, and a website-style presentation for stakeholder review. The UI should switch presentation modes without changing the underlying logic cards.",
      "status": "ready",
      "linkedFiles": [
        "packages/desktop/preview/logic.js",
        "packages/desktop/preview/app.js",
        "docs/DOCUMENTATION_PRESENTATIONS.md"
      ],
      "dependencies": [
        "card-logic-schema",
        "card-logic-board-ui"
      ],
      "relatedCards": [
        "card-persistent-workspace"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-vscode-handoff",
      "title": "Open in VS Code",
      "summary": "Open a card worktree, project folder, or linked file in VS Code.",
      "details": "Code remains behind the logic surface. Users can jump to VS Code only when they need file-level editing or to inspect an agent worktree.",
      "status": "ready",
      "linkedFiles": [
        "packages/desktop/src-tauri/src/main.rs"
      ],
      "dependencies": [
        "card-agent-coordinator"
      ],
      "relatedCards": [
        "card-logic-board-ui"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-local-gemma-brain",
      "title": "Local Gemma Brain",
      "summary": "Use Gemma 3 4B through Ollama now, with Auto/custom model selection.",
      "details": "The MVP should always show whether the agent brain is online. Auto prefers installed Gemma 3 models, defaulting to gemma3:4b. Agent runs call the local Ollama API when available and otherwise remain explicit simulations.",
      "status": "ready",
      "linkedFiles": [
        "packages/desktop/preview/models.js",
        "packages/desktop/src/lib/models.ts",
        "runtime/model-manifest.json"
      ],
      "dependencies": [
        "card-logic-board-ui"
      ],
      "relatedCards": [
        "card-real-agent-worker",
        "card-packaged-runtime"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-persistent-workspace",
      "title": "Persistent Logic Workspace",
      "summary": "Keep preview edits across refresh and mirror the Tauri save/load contract.",
      "details": "The browser preview should persist card edits, statuses, links, selected cards, and activity in localStorage so users can test-drive the workflow. The Tauri app uses the same contract with project JSON and generated Markdown.",
      "status": "ready",
      "linkedFiles": [
        "packages/desktop/preview/app.js",
        "logic/open-code.project.json"
      ],
      "dependencies": [
        "card-logic-schema",
        "card-logic-board-ui"
      ],
      "relatedCards": [
        "card-human-conflict-resolution"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-human-conflict-resolution",
      "title": "Human Logic Conflict Resolution",
      "summary": "Let humans resolve design conflicts by editing, unblocking, or marking cards obsolete.",
      "details": "Logic conflicts should not be auto-merged. The UI needs explicit actions to select conflicting cards, resolve declared conflict links, remove missing dependencies, and mark obsolete logic blocked.",
      "status": "ready",
      "linkedFiles": [
        "packages/desktop/preview/app.js",
        "packages/desktop/preview/logic.js"
      ],
      "dependencies": [
        "card-conflict-model",
        "card-persistent-workspace"
      ],
      "relatedCards": [
        "card-real-agent-worker"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-real-agent-worker",
      "title": "Real Agent Worker",
      "summary": "Turn a ready card into model-backed code changes in its worktree.",
      "details": "After a card starts, the worker should prompt Gemma with card intent, linked files, dependencies, and conflict report, then produce implementation notes and code changes on the card branch.",
      "status": "draft",
      "linkedFiles": [
        "crates/open-code-logic/src/lib.rs",
        "packages/desktop/src-tauri/src/main.rs"
      ],
      "dependencies": [
        "card-agent-coordinator",
        "card-local-gemma-brain",
        "card-human-conflict-resolution"
      ],
      "relatedCards": [
        "card-packaged-runtime"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    },
    {
      "id": "card-packaged-runtime",
      "title": "Packaged Model Runtime",
      "summary": "Bundle a local inference sidecar and manage Gemma download/verification.",
      "details": "Ollama is the MVP path. The product path bundles a llama.cpp-compatible runtime, stores models under app data, verifies checksums, and exposes one local HTTP API for agents.",
      "status": "draft",
      "linkedFiles": [
        "docs/AGENT_RUNTIME.md",
        "runtime/model-manifest.json"
      ],
      "dependencies": [
        "card-local-gemma-brain"
      ],
      "relatedCards": [
        "card-real-agent-worker"
      ],
      "implementationBranch": null,
      "worktreePath": null,
      "conflicts": [],
      "agentRuns": []
    }
  ],
  "links": [
    {
      "from": "card-agent-coordinator",
      "to": "card-logic-schema",
      "kind": "dependency",
      "reason": "Agent work needs stable card ids and linked files."
    },
    {
      "from": "card-conflict-model",
      "to": "card-logic-schema",
      "kind": "dependency",
      "reason": "Conflict detection runs over structured cards and links."
    },
    {
      "from": "card-logic-board-ui",
      "to": "card-conflict-model",
      "kind": "dependency",
      "reason": "The UI must explain which conflicts need humans."
    },
    {
      "from": "card-documentation-presentations",
      "to": "card-logic-schema",
      "kind": "dependency",
      "reason": "Every presentation renders from the same structured project graph."
    },
    {
      "from": "card-documentation-presentations",
      "to": "card-logic-board-ui",
      "kind": "dependency",
      "reason": "The presentation switcher belongs in the main logic workspace."
    },
    {
      "from": "card-local-gemma-brain",
      "to": "card-logic-board-ui",
      "kind": "dependency",
      "reason": "The model status belongs in the main logic workspace."
    },
    {
      "from": "card-persistent-workspace",
      "to": "card-logic-board-ui",
      "kind": "dependency",
      "reason": "Persistence makes the preview useful as a real planning surface."
    },
    {
      "from": "card-human-conflict-resolution",
      "to": "card-conflict-model",
      "kind": "dependency",
      "reason": "Resolution actions depend on the conflict classifier."
    },
    {
      "from": "card-real-agent-worker",
      "to": "card-local-gemma-brain",
      "kind": "dependency",
      "reason": "Real workers need an online local model brain."
    },
    {
      "from": "card-real-agent-worker",
      "to": "card-human-conflict-resolution",
      "kind": "dependency",
      "reason": "Workers must block when a card has human-required logic conflicts."
    },
    {
      "from": "card-packaged-runtime",
      "to": "card-local-gemma-brain",
      "kind": "dependency",
      "reason": "The packaged runtime replaces the MVP Ollama dependency after the brain contract is stable."
    }
  ]
}